Users Guide 


=f. g.8.2_&.2F_£_E gE. gE EB. gs Rk Eee 


J) 4) 3 


jJyiiijisd)] 


] 


jo] 


Trant 


Or 


> An Adaptec Company 


SCSI vorts : 


ASPI Software & Utilities 


Including: 


Mate: 


Photo CD Viewer CD-ROM Audio-Contro! SCSI Tape Backup 
Software Software 


Stock # TR510052-00 Rev. A 


SCSI ivorts User Guide 


Copyright 

Copyright © 1993 Trantor Systems Limited. All Rights Reserved. No part of this publication may be 
reproduced, stored in a retrieval system, or transmitted in any form or abel) means, electronic, 
mechanical, hotocopying, recording or otherwise, without the prior written consent of Trantor Systems 
Limited 5415 Randall Place Fremont, CA 94538 USA. 

Trademarks 


MiniSCS!, SCSIworks!, Trantor, the Music Box logo, the Tape Mate logo, and the Trantor logo are 
trademarks of Trantor Systems Limited which may be registered in some jurisdictions. 


Bemoulli is a tademark of lomega Corporation which may be registered in some jurisdictions. 
SyQuest is a trademark of SyQuest Technology, Inc. which may be registered in some jurisdictions. 
Floptical is a trademark of Insite Peripherals, Inc. which may be registered in some jurisdictions. 


Magic Lanter and the Magic Lantem logo are trademarks of Incat System srl which may be registered in 
some jurisdictions. 


Hewlett-Packard, HP, and ScanJet are trademarks of Hewlett-Packard Corporation which may be 
registered in some jurisdictions. 


IBM, AT, OS/2, and PS/2 are trademarks of Intemational Business Machines Corporation which may be 
registered in some jurisdictions. 


Microsoft and MS-DOS are trademarks of Microsoft Corporation which may be registered in some 
jurisdictions. 

Novell and NetWare are trademarks of Novell, Inc. which may be registered in some jurisdictions. 

QEMM is a trademark of Quarterdeck Office Systems which may be registered in some jurisdictions. 
386Max is a trademark from Qualitas, Inc. which may be registered in some jurisdictions. 

Kodak is a trademark of Eastman Kodak Company which may be registered in some jurisdictions. 
DeskLink and LapLink are trademarks of Traveling Software which may be registered in some jurisdictions. 
Hercules is a trademark of Hercules Computer Technology which may be registered in some jurisdictions. 
sal is a trademark of Sharp Kabushiki Kaisha (Sharp Corporation) which may be registered in some 
jurisdictions. 

Changes 

The material in this manual is for information only and is subject to change without notice. 

Trantor reserves the right to make changes in the product design without reservation and without 
notification to its users. 

Technical Support 


Trantor software has been specifically developed for easy installation and use. We hope that our manuals 
and the on-screen instructions and help are complete and clear enough to meet your needs. If you need 
further help, please contact us. 


The Adaptec/Trantor Electronic Bulletin Board Service (BBS) provides information on software upgrades, 
new releases, technical advice, and other topics. You can reach the BBS 23 hours a day at 
408-945-7727; 1200/2400/9600 baud, 8 data bits, 1 stop bit, no parity. 


To contact the Technical Support Hot Line, call 800-959-SCSI (7274) or 408-945-2550, M-Th: 6:00 a.m. to 
5:00 p.m., F: 6:00 a.m. to 3:00 p.m., Pacific time. 
interactive FAX Service 


The Adaptec Interactive FAX Service, which provides the latest on-line information about Adaptec/Trantor 
roducts cy retail 23 hours a day, 7 days a week. To reach the Adaptec Interactive FAX 
ervice, call 408-957-7150. 


Ordering Software 
To order Trantor software, call 800-TRANTOR (872-6867), M-F: 8:00 a.m. to 5:00 p.m., Pacific time. 


Literature Hotline 


To request additional documentation for Trantor products, call 800-TRANTOR (872-6867), M-F: 8:00 a.m. 
to 5:00 p.m., Pacific time. 


Rev. A October 1993 Printed in USA 


ne 


Tyo) 39) F VY 39 1 7 


J J 


’ 


NOTE 


If you're like many users, you'll want to Bet started using your new 
equipment as soon as possible. Chapter 3 of this manual gives a quick 
overview of the installation process. It will save you time in the long run, 
(om and make you aware of many options you might otherwise miss. 
Remember, you can always change your system configuration at a later time. 


_" For technical puppore of this Brodit please see your dealer first for 
a , assistance, as he/she is most | es understand your specific needs and 
e uipment setup. To be eligible for any Trantor factory technical support 
ahi may be necessary, your Product Registration Card must be on file 
a with us. Please fill out and mail in your Product Registration Card within 
10 days of purchase! 


Notice (applicable to Music Box TSR Application only) 
This product uses the TesSeRact Ram-Resident Library and supports the TesSeRact Standard for 


om Ram-Resident Program Communication. For information about TesSeRact, contact the TesSeRact 
“s, Development Team at: 


TesSeRact Development Team 
c/o Chip Rabinow 
anna 2084 Woodlawn Ave. 
Glenside, PA 19038 
215) 443-9705 
ompuserve: 70731,20 MCIMAIL: 315-5415 


d 


j 


iJ 


} 


J 


} 


J 


fF € € t € € € € € € C€ € € € € € € &€ € € € t 


! User Guide 


iv 


) 3.1 3 


J 


[ee 


7 


Table of Contents 
1 SCSlIworks! Introduction .........ccccccccccccccccecees 1 
1.1 The SCSIworks! Package ......... cee cece eee e ene aes 1 
WAH, «Checklist 3:c3:03 oo euaw1'o dee ee ie wae 3 
1.1.2 SCSlIworks! Files ......... 0... cece eee ee eee 3 
113° Requirements: tai teens irne-$h0Ge tice a awed 4 
1.2 Manual Conventions .........ccccccccccccccccccceens 4 

I Drivers & Utilities 
2 Drivers & Utilities Overview .........cccccccccccccccces 9 
2.1 Software Features. ........ ccc cece cece cece eee eeeaes 9 
2.2 Software Overview ........cc ccc ccc cece cece cccccecees 9 
3 Installation Overview ......ccccccccccccccscccccccuce 13 
4 Software Installation ....... ccc cc cc cccccccccccccces 15 
Al. Installation Steps. cs civite ts cakes scaweeteseees 15 
4.1.1 Running the INSTALL Program ............... 16 
4.1.2 Checking the Installation .................04.. 20 
4.1.3 Testing the SCSI Hardware ...............004. 21 
5 Hard Disk Software Operation ...........ccecceccceecs 25 
5.1 TFORMAT (Formats Storage Media) ee ere 25 
5.2 TSPAN (Span One Partition Over Several Drives) ........ 29 
5.3 TSTATUS (Checks Status of Your System) ............. 30 
6 CD-ROM Software Operation ...........cccccccccece 33 
6.1 MSCDEX, the DOS CD-ROM Extensions ............. 33 
G2, “GHRCD voice i eee tees eet rales: 35 
6:5: “LEOCK. sc. .cuis se nanneyeee te dat data eeea ns 35 
GA. “TUNEOCK 9 6 65 6.¢-4cdaw cn Oa aes be karts ee elacdcana ea aes 36 
65> TEECE gictatcesaeetutois aitontes Leoeoneeseers 36 
7 Scanner Operation .......cccccccc ccc ccrcccccccccens 37 
WA SCanner Piles 42h 25 Kd cook ee oe wes Sod Shh Ws eb 37 
7.2 How Your Scanner Functions ............000e eee eeees 37 
Po. “Scanner Digenostics” soa 5d thas ods tyne oe eed 38 
8 Device Driver Options ...........ccccccrccccccccccces 39 
8.1 How to Identify Software Versions ..............0 0000. 39 
SZ. JDrivert SUPPOIt- j.5 cease esas ed aaa ae daenn es 39 
8.3. Driver Command Line Switches ..............0000000s 39 
9 OS/2 Software Installation ....... ccc ccc ccc ccc ccc cece 43 
9.1 Installing OS/2 2.1 Device Drivers ........... 0.000000. 44 
9.2 Removable Media (Magneto-Optical, SyQuest, Bernoulli, etc.)....... 44 
9.3 Setting Up a Hard Drive for OS/2 Software Use.......... 45 
Vv 


SC Shots: User Guide 


9.4 OS/2 Software Error Messages .......... 000 e cee eeeeees 45 

10 Windows NT Software Installation ..............000e00- 47 
10.1 Trantor NT SCSI Miniport Installation ................. 48 

11 NLM Software Installation ........... cece eee e ccc eeee 49 
Lieh SNEM Untroduchon'<y 4.04x <b osiweiwceman cues aieaanh es 49 
VIG) ‘Cheeklist<. sia oa Gcteto%s a awearw aceurucapea aedvae Rae 49 

Pl? INE Files) ndusd eacie eins daeuvanad dco cadadaaue 50 

Th: INEM Installanon coed ncawadoe ki ws 50k aod ae aoe 50 
11.3 Warning and Error Messages ......... 00. e eee e eee eeee 53 

12 Troubleshooting Notes ...........0cccccccccccccecece 55 
12-1 “All Host Adaptets isoo cooisudaaciews ees eww dan sea 55 
12.1.1 Parallel-to-SCSI Adapters ............ 00 eee cease 55 

12-2 » Techical Support: ii. sos 24.04.04 ena twee ae seas 56 


II Magic Lantern Software 


13 Magic Lantern Operation ..........cccccecccccvcccecs 61 
13.1: -Mapice Lanvein Overview a ia1024io2 55s seo wo wesaees 61 
13.1.1, Magic lantern Piles o5.003%.000s00064oee Soaysas 61 

13.2 Magic Lantern Installation .......... 0.0 61 
19:3: “OperanOn:b.00 cass ated ess Saghenses ase eames 62 
13.3.1: Mouse Conttol sos e.5c00ciasedasriavendagwen 63 

13.3.2 Keyboard Control .......... 0.2 ee eee eee eee 63 

13.4 Magic Lantern Troubleshooting ................000eeee 64 


III Music Box Software 


14 Music Box Operation ........cccecececececccccceececs 69 
14:1, Music Box Biles: 52.505.6-24.46vguud ated iecaedtawaded ee 69 
14.2; Requireniétits.cisictiaewadosussane ie exeeee Glee ees 70 

LAD A atWates cor nhitaomee tbc on cakese eeee aeons 70 
142.2 Soltwate s cinsciecasuadeseaesasoacaessean sees 70 
14.3. Music Box Installation 0: esc cosceduwvnt 4b teu eww 70 
14.4 Running Music Box Software ........... 0c eee e wees 71 
14.4.1 From the DOS Command Line ................. 71 
14.4.2 Running Music Box Software with Microsoft 
WINdOWS acricasasactaqeawnametvon A Medseedes 72 
14.5 Learning Music Box Software .......... 2... cess eee eee 73 
14.5.1 “Mouse Conttol5.i6s's shtcgirass cceavnessesouns 74 
14.5.2 Keyboard Control ......... 0... cece eee eens 74 
14.5.3 Music Box Control Functions ...............65- 74 
14.5.4 Using the Windows 3 Version ..............205- 75 
14.5.5 Running Music Box Software in Memory-Resident 
MGdE- irstoitNne ts Sih e enna ee ewes 78 
vi 


1yvITI973 


$3939) 97) 3 9 


ee 


d 


| 


Table of Contents 


14.5.6 Music Box TSR Software Commands and Audio 


Intetiace: santyokedeaideteeewew ser dueweta tt 80 
14.5.7 Unloading Music Box TSR Software ............ 81 
14.5.8 Reloading Music Box TSR Software ............. 81 
14.6 Music Box Troubleshooting .............. 00 cc eee uee 81 

IV Tape Mate II Software 
15 Introduction to Tape Mate II Software .............2000. 85 
15.1, ‘Hatdwate Sup pott-s.40ceciddiacsenetesadeetinasndss 85 
1.2 “Tape Mate ti Peatires ic nunca Seated etsas bX 85 
15.3 Using the Tape Mate II Section of this Manual........... 85 
16 Installation and Configuration ............00eceeeeeees 87 
IG). ‘Belore You Betin ec s.:2 255s tivteint coe aware aweds 87 
16.2 Installing Tape Mate II Software ..............-000000- 87 
16.3 Configuring Tape Mate II Software for Your Device ...... 88 
17: Getting Started: 6:c:6ie6.0355-5.216 4.598 oe Greases 91 
17.1 Terms You Should Know .......... 0... cee eee eee aes 91 
172 CONCEDES 35 ee dented waee unr nd ee os ek Sea oes 91 
17.3 Starting Tape Mate II Software ............. 0.0020 eee 92 
17A: “The Maint Scteen 2y-ccsie ies auke ati ns aA ies 92 
17.5. Selecting Items. 9.5 Guiieitiocuwietatecdaaeuiawie 92 
17.6 Entering Information in Dialog Boxes.................. 93 
U7.7 - Keyboard Keys si:i0.c.ctsa rend aorelioedmeatrdaaambis 93 
17.8 Using the Mouse: i csnciat ootve  aotiuus cist ese banat 93 
L790) Getting Help iaiacsvewcis caemeiener ease edes seeks 94 
17.10 Quitting Tape Mate II Software ............ eee ee eee 94 
17.11 Do’s and Don’ts in Tape Mate II Software .............. 94 
18 Backup Operation ..........cceccccccccccccscccccvce 95 
1S.) ‘Overview’ s s:4s.eraeaetintea eaten tu aeeaeaa wae 95 
18.2. Performing 4 Backtp scence Us car tesaitetete pants s 96 
18.3. Selecting Run Time Options ........... 0... 0c eens 100 
18.4 Specifying Session Parameters ............ 0.000 eee eee 101 
18.5 Selecting Drives, Directories, and Files ................ 102 
18.5.1 Setting Default Parameters ..............0000- 102 
18.5.2 Setting Different Parameters for Different Drives .. 106 
19 Restore Operation ......ccccccccccccccscccccccesess 109 
19.1. Restonne Data sca tta nates tio wiee see ts Ges ae tes 109 
19.2 Restoring a Multiple-Volume Session ................. 111 
19.3 Setting the Restoration Parameters .............00 000 111 
19.3.1. Destination Drive: nc.:csic etc ak oven eine Se 112 
193.2, Destination Path ¢ cscic ino eosin ences eek’ 112 
19:3.5° Run Time Ootions:¢ 2322.9 it seca ewkaw ates 112 
19,34: Source Session «35,5068 sewosae eek osha e sees 113 


SC Shots User Guide 


19.3.5 Since Date and Before Date ................-4. 114 
20° Verily Operation, 6:i5-i00 6800s o sda tenewsaseawees 115 
21 Unattended Operations ...........cccccccccccceccces 119 
21.1 Immediate Unattended Operations ................06: 119 
21.2 Delayed Unattended Operations ...............0 0000 119 
21.2.1 Scheduling the Start Time .................44. 120 
21.2.2 Activating the Tape Mate II Scheduler........... 121 
21.2.3 Enabling the Log History Option .............. 121 
22° Script Piles pccescisa bis sa taee ees es ees se seas scuss 123 
22.1. Creating a: Scupt Vile... oS aictekl weaea tbendcecuss 123 
22.2. Bditine 4 Script Pile cc.desenawaeaae whee vie cee ened 124 
22:3: Deleting a Script Pile: 4.00.00 5.ccsucisgesaeensesseeneoaas: 125 
22.4 Script Language Commands ..............-00 see c eee 125 
22.4.1 Command Format ..............ee cece ce eees 126 
22.4.2 Command Descriptions ........... 2.000 sees 126 
22.9, SCUPUPUC HORMNAl <duws iat weotsmet ons hinted eee oe 129 
22.5.1 Attended Script Files ..................2 0008. 129 
22.5.2 Unattended Script Files ...................05- 130 
22.6 Validatine a Script Piles uicseeseensed beer esenieasen 132 
23 Database Resources ........ccccccccccccccsccccccens 133 
23.1 Volume Database Maintenance ..............0 eee eee 134 
23.2 Session Database Maintenance ................0 0000 135 
23.3 Adding a New Volume .............. 0. cece cece sree 136 
234° Purcing the Database siag:d:sl oe Sams ccd tee eee te’ 136 
23.5. . Exiting the Menu is <oci ices cis.d-ocee ted ak saw aetedas 136 
24. Utility Meat, 46.6350 sich sii dewes s bese aeee esas 137 
24-1. “Inieializing: Media i.s:xagrercusaiesdoe uiieei sak ope es wxerarsee 137 
24.2 Retensioning Media ............ 0c eee e cece eee e eens 138 
24:5 Byecting Media: a.eics Vas ntousocs-eeetwwnpaanernvorat’ 139 
24.4 Printing a (0s sto. 5 eie ds tceeu eee cet eeadeedekant 139 
24.4.1 Viewing and Printing a Log History File ......... 139 
24.4.2 Deleting a Log History File ................0.. 139 
24.5 Obtaining General Information ................0.000. 140 
24.6 Exiting the Utility Menu ............... 0. eee eee 140 
25 Configuration Menu ..........ccceccccccccccccceces 141 
25.1 Local Configuration Parameters ......... 0.00 cece eee 141 
25.2 Global Configuration Parameters ............00 eee eee 143 
25.3 Exiting the Configuration Menu ................0000. 145 

Viil 


por 
a 


y739)7 9 39 3 9 9217) 9 


j 


Table of Contents 
26 Tape Mate II Upgrade Options ..............ceeeeeee 147 
V_ Appendices 
A System Requirements ..........cccccccccccvcvcccces 153 
B_ Introduction to ASPI.... 0.2... cc cece cece cece ccccecs 155 
1X 


SCShvors User Guide 


1 SCSlIworks! Introduction 


This manual describes Trantor’s SCSIlworks! ASPI software and utilities 
package. This manual also includes a detailed explanation of its features, 
installation, and operation. 


The SCSIworks! Package 
SCSIworks! software is a unique comprehensive ASPI (Advanced SCSI 


Programming Interface) software package including device drivers, 
applications, and operating system support. The software described in this 
manual is supplied standard with Trantor’ host adapters and functions 
similarly on each. 


The ASPI Solution 


SCSIworks! software makes SCSI easy to use and eliminates compatibility 
problems by acting as the mediator for ASPI hardware and DOS/Windows 
operating environments as well as ASPI applications. See Figure 1. 


Essentially, there 


DOS/Windows ASPI Applications Scanner 
ee Applications Applications 


ASPI imple- 


mentation, the 

ASPI manager, a 
device driver 

supplied by the -. 
hardware 
manufacturer, and 
the ASPI software 
application. The 
manager creates 
the standard ASPI- 
compatibility layer 
between the SCSI 
host adapter 
hardware and the 
ASPI-compatible 
application. The 
manager Is very 
hardware-specific 
and is almost 
always supplied by 


the manufacturer 


* ASPI Manager for another SCSI adapter 


fo» A Compatile SES adapter tom 
of your SCSI host Trantor or other manufacture. 
adapter. Figure 1 SCSlIworks! Software ASPI Diagram 


J 


SCShrois User Guide 


Referring to Figure 1, you can see that the ASPI hard disk, CD-ROM, and 

scanner drivers actually work through the ASPI manager to perform their ae 
functions. Also, DOS & Windows applications which access SCSI devices = 3 
work through both the drivers and the manager. ASPI applications (such as om 
tape backup software) usually access the ASPI manager directly. See 

Appendix B for more ASP] details. as 


Since SCSIworks! software is ASPI-compliant, it may be used with other 
manufacturer’s ASPI-compatible hardware. And since Trantor’s SCSI —_ 
hardware provides the ASPI manager, you may interface with other 
manufacturers’ ASPI-compatible applications. 


Device Support 
SCSIworks! software provides CD-ROM, hard disk, removeable-media, aaaaal 
tape, and scanner device drivers for any ASPI-compatible SCSI host 
adapter. SCSIworks! driver support includes: 


¢ CD-ROMs (including single and multisession Kodak® Photo CD) 


e hard disks pw 
° magneto-optical drives 
¢ SyQuest” drives as 
¢ Bernoulli® drives ae 
° Floptical® drives 
¢ Hewlett-Packard® ScanJet® II scanners pe 
¢ SCSI floppy drives 
e SCSI tape drives = 
[35> To use your tape drive, install the Tape Mate IT software (see Chapter a 
15) for use with DOS or use any other ASPI tape backup application. _ 
Applications Included poe 
SCSIworks! package offers three applications. These applications allow _ 
you to view photo CDs, listen to music CDs, and use your tape drive. ‘sana 
These applications include: | 
¢ Magic Lantern™ Photo CD Viewer anil 
¢ Music Box CD-ROM audio control software | 
¢ Tape Mate II SCSI tape backup and restore software pom 
Ess Magic Lantern software requires Windows and a photo CD compatible 


CD-ROM drive (see Chapter 13), and Music Box software requires 
Microsoft® CD-ROM Extensions (MSCDEX) and an audio-compatible 
CD-ROM drive (see Chapter 14). Tape Mate II software provides 
support for SCSI tape drives and is certified to function under DOS (see 
Chapter 15). See Appendix A for other hardware and software requirements. 


SCSIworks! Introduction 


Support for Trantor Adapters 


SCSIworks! software offers additional support for all Trantor host 
adapters by providing: 


¢ ASPI managers 

¢ OS/2® drivers 

¢ Windows NT drivers 

© Novell® NetWare® v3.11 or later Loadable Modules 


To use your devices under OS/2, Windows NT, or Novell NetWare 
operating systems, use the appropriate operating system device drivers and 
applications. 


1.1.1 Checklist 


You should have received the following items in your software package: 


() 34-inch, 1.44-MB SCSIworks! distribution diskette #1 
L) 3Y-inch, 1.44-MB SCSIworks! distribution diskette #2 
QL) SCSIworks! User Guide (this document) 


Q) Product registration card 
QO) Microsoft® registration card (for MSCDEX) 


If anything is missing, please contact your dealer immediately. Be sure to 
fill out and return your product registration cards to be eligible for 
warranty support and technical assistance. 


1.1.2 SCSIworks! Files 


Your SCSIworks! diskettes contain directories and files as outlined in this 
table. Details of these files can be found in the chapters listed. 


[Files —S—s—s—s—~Ss«é(Disk # (Directories _—_—([Details In _| 
Drivers & Utilities, Installation ) 1 [Rot | Chapter 2 
Chapter? 

S2 


\O 

\SCANNER | 
ISCANNER ___—_‘[Chapter2 | 
Chapter 
\WINNT Chapter 10 
Chapter 11 


SCSI User Guide 


1.1.3 Requirements 


The following is a list of the requirements for SCSIworks! drivers. See 
Appendix A for additional Magic Lantern, Music Box, and Tape Mate II 


hardware and software requirements. 


¢ IBM® or compatible AT®, PS/2°, or similar computer. 

¢ MS-DOS®, PC-DOS 3.1, or above. DOS 3.3 or above is required 
to format and use partitions larger than 32 MB. 

¢ A 100% IBM-compatible BIOS. Operation with some incompatible 
BIOSs may be possible but is not guaranteed. 

e At least 640 KB of system memory. 


1.2 Manual Conventions 


Since SCSIworks! software provides ASPI interfacing, any references to 
“host adapter” or “adapter” in this User Guide refers to Trantor’s as well as 
any other manufacturer’s SCSI host adapter that is ASPI-compatible, 
having the appropriate ASPI manager. 


0S This manual assumes that your host adapter has been successfully installed 


in your computer system following the instructions in the Trantor 
Hardware Installation Guide or other manufacturer’s installation 
documents. If you have n is i i | 


attempting to install and run the software described in this document. 


This manual is divided into four sections—Part I Drivers & Utilities, 
Part IT Magic Lantern Software, Part III Music Box Software, Part IV Tape 
Mate II Software, and Part V Appendices. 


Typeface and Writing Conventions 


There are several typeface conventions used in this manual. These 
conventions represent different things and are used to make reading this 
manual easier. 


Bold Print Represents text to be selected or messages that appear in 
a dialog box, on a menu, or on screen. 

Courier Text or commands to be entered from the keyboard. 

Bold 

EUROSTILE On screen Music Box buttons to be pressed using the 

BOLD mouse. 

Italic Print Indicates chapter, section, appendix, and figures, and 
references. Magic Lantern and Music Box software are also 
represented by italic type. 

4 


Y3)79 79 F IT 1} 911397 J 


Ij 


Jo} 7 7] 


13 


[Brackets] 


CAPS 


SCSIworks! Introduction 


Identifies control and function keys on the keyboard. For 
example, the notation [Enter] means to press the [Enter] 
key on the keyboard. When two or more notations in 
brackets are connected with a hyphen, as in 
[Ctrl]-[Alt]-[Del], press the indicated keys 


simultaneously. 


Designates directories, subdirectories, and file names in 
your computer system like AUTOEXEC.BAT and 
CONFIG.SYS. They are also used to designate on-line 
or Tape Mate II script language commands. 


Cr eELrELeEELE LE EEELEECOE ERE LEE EL 


! User Guide 


SCSI rots 


Drivers & Utilities 


o 
oe 
S 
my 
N 
a 
CS 
ane 
peur, 
Le OD 
ane 
‘a? 
DBD 


fF ktcktet_et £et t € € Etec £t etree es 


SOE] \SIOALIC] 


2 Drivers & Utilities Overview 


Drivers & Utilities details installation, configuration, and use of the 
SCSIworks! ASPI CD-ROM, hard disk, and scanner drivers and utilities. 
These drivers support CD-ROMs; hard disk, magneto-optical, SyQuest, 
Bernoulli, Floptical, SCSI floppy, and SCSI tape drives; and HP” ScanJet 
II scanners. This chapter is an introduction to the Drivers & Utilities 
section. 


035° Software for all devices (except CD-ROMs and scanners) refers to “hard 
disk” software, since these devices all share the same hard disk device driver 
and utilities. 


2.1 Software Features 
The software has several important features which include: 


¢ Simple installation and configuration, including automatic updating 
of your AUTOEXEC.BAT and CONFIG.SYS files. 

¢ Support for the ASPI specification, permitting use of ASPI software. 
See Appendix B for more information. 

¢ Spanning capability, which allows you to treat two or more erasable 
SCSI devices (either fixed or removable media) as a single large 
device. 

¢ Formatting routines which automatically identify all connected 
devices and media, allowing partitioning and verification. 

° Media format compatibility, so that you may interchangeably 
connect your SCSI devices to any Trantor SCSI host adapter 
installed in other IBM-compatible computers. 

¢ Simple installation menus which allow you to easily call SCSI device 
media format routines, set spanning selections, and test your SCSI 
interface and devices. 


2.2 Software Overview 


The software distribution diskettes contains a number of important files. 
The following is a brief summary of the files contained in the root 
directory of disk #1: 


INSTALL.EXE—The main setup and installation program which provides 
a “shell” to 


Copy all software files to your system > 

Format SCSI device storage media (fixed and removable) 
Configure SCSI device spanning 

Test all SCSI devices connected to the adapter 


Separate programs (below) perform some of these functions. 


Ss) 
‘a 
= 
ie) 
»t 
H 
a 
ot 
pt © 
jah o 
ot 
jaa © 
Oo 
2) 


A 
YU 
‘S 
= 
Ja 
a 
an 
A 
yam 
VY 
> 
ou 
Yeung 
Q 


QC Shore! User Guide 


CDINSTAL.EXE—The CD-ROM installation routines, initially run via 
the main INSTALL program. Use CDINSTAL.EXE to change 
CD-ROM operation options at a later time. 


HDINSTAL.EXE—The hard disk installation routines, initially run via 
the main INSTALL program. Use HDINSTAL.EXE to change hard 


disk operation options at a later time. 


SCINSTAL.EXE—The scanner installation routines, initially run via the 
main INSTALL program. Use SCINSTAL.EXE to change scanner 


operation options at a later time. 


MAxxx.SYS—ASPI manager files (see Appendix B for ASPI details) for 
various Trantor SCSI host adapters. Only one of these is copied to your 
system during the installation process. 


TSCSI.SYS—tThe hard disk device driver file which links the hardware to 
your computer’s operating system. It must be loaded through your 
system’s CONFIG.SYS file; INSTALL.EXE modifies your 
CONFIG.SYS file automatically. This driver is not needed for 
CD-ROM or scanner operation. 


TSTATUS.EXE—A status utility which informs you of 


e The revision level of the TSCSI.SYS driver. 
¢ How much memory is used by TSCSLSYS. 
e The SCSI drives connected to your adapter and their capacities. 


Note that this program does NOT work with CD-ROMs, scanners, or 
tape drives. 


SCSITEST .EXE—A test utility to search for all SCSI adapters and devices 
connected to your computer and report the results. This driver is used 
to confirm that your SCSI adapter and all SCSI devices are properly 


connected and configured. 


TFORMAT.EXE—A SCSI formatting utility used to format and partition 
the storage media of your SCSI drives. Works with both fixed (hard 
disk) and removable (cartridge or floppy) drives. Options include the 
ability to define more than one logical partition (drive letter) per drive 
and to verify the reliability of the media after formatting. 


manager (MAxxx.SYS) must be loaded in order for TFORMAT to 
function, 


TSPAN.EXE—Allows you to create one large logical drive (C, D, E, etc.) 
from two or more SCSI devices by “spanning” them via software 
control. Note that the spanned devices must either be all fixed or all 
removable; spanning fixed and removable devices together is not 
permitted. It is possible, however, to use more than one spanned set of 


10 


TVPVPIYVPYVYVIIYVIVPyvAvproiadys 


2 Drivers & Utilities Overview 


devices simultaneously; for instance, a spanned set of hard disks may be 
used along with a different spanned set of removable cartridges. The 


ASPI manager (MAxxx,SYS) must be loaded in order for TSPAN to 
function, 

TSLCDR.SYS—The CD-ROM device driver file which links the 
hardware to the operating system. It must be loaded through your 
system’s CONFIG:.SYS file; INSTALL.EXE modifies your 
CONFIG.SYS file automatically. TSLCDR.SYS, TSCSLSYS, and 
TSJII.SYS must be loaded to support CD-ROMs, hard disks, and 


scanners simultaneously. 


MSCDEX.EXE—Microsoft’s CD-ROM extensions to MS-DOS, licensed 
by Trantor. It is generally loaded from AUTOEXEC.BAT. See Section 
6.1. Be sure to register your MSCDEX. dtiver with Miccosolt 


) AA I 
diccbucot aya 


CHKCD.EXE—A utility, similar to the CHKDSK program supplied with 
DOS, to display status information about a CD-ROM. 


TLOCK.EXE—A utility designed to prevent ejecting a disc from a 
CD-ROM or other removable-media drive by pushing the drive’s front 


panel button. 


TUNLOCK.EXE—A utility which is the opposite of TLOCK; it 
“unlocks” a CD-ROM or other removable-media drive, permitting the 
disc to eject by pushing the drive’s front panel button. 


TEJECT.EXE—When executed from the DOS command line, ejects the 
currently 


loaded dise(s) from a CD-ROM or other removable-media drive. 
READ.ME—A text file which may be included, containing up-to-date 


information since this manual was printed. It is important that you 
look for this file and, if it exists, read it carefully. 


Auxiliary Files 
*,OVL—Overlay files used during installation only. There are several 


versions supplied, only one of which is used for any particular Trantor 


SCSI interface product. 


* INF—Text information files used during installation only. There are 
several versions supplied, only one of which is used for any particular 
Trantor SCSI interface product. Note that you must not modify these 
files in any way; if you do, the installation process halts. 


S) 
=P 
A 
p= 
nN 
mn 
S 
=o 
| 
ot 
a 
¢") 
oe) 


*.MSG—Messages that appear on screen during the installation process. 


11 


D 
Y 
. um 
_ 
owt 
= 
=) 
et 
A 
o 
> 
© wa 
Seng 
a 


SC Shots: User Guide 


Old Files 


Your distribution diskette #1 has an \OLD subdirectory, containing a 
number of old drivers and utilities files. These are only important if you 
have an old Trantor host adapter. 

Scanner Files 


Your distribution diskette #1 has a (SCANNER subdirectory, containing a 
number of scanner files (see Chapter 7 for more details). 


12 


Jy 7°) FY FY F YF} 1 Tt 1 FT 1 


J 


I 


Iorg 


J 


3 Installation Overview 


This quick overview is intended to summarize the various steps involved 
with installation and configuration of your hardware and software. New 
users should thoroughly read the remainder of this manual before 
proceeding with installation and configuration! 


1 Referring to your Hardware Installation Guide or other installation 
instructions supplied with your hardware, install the SCSI host adapter 
in your computer system. It’s important that the hardware be carefully 
and completely installed prior to using the software described in this 
manual. 

2 Connect the SCSI device(s) to be used with the host adapter. The last 
(or only) SCSI device connected to the host adapter should be properly 
“terminated,” per the device manufacturer’s specifications. See your 
dealer for termination assistance if necessary; a terminator is often an 
optional accessory. 

3 Set the device address between 0 and 6 (see your device manual for 
details). If you are using more than one SCSI device, make sure that 
each device is set to a different address. 

4 Power up the computer system and allow it to boot. Place the software 
distribution diskette # 1 in a floppy disk drive and log onto that drive. 


03> Ifyou plan to use your Trantor SCSI adapter under OS/2 2.0 or later, 
skip to Chapter 9 now for installation information. Skip steps 5-7 
below. Note that only the ADD files supplied by Trantor are 
applicable under OS/2—all other Trantor drivers and utilities are 
not used with OS/2. 


03> If you plan to use your Trantor SCSI adapter under Windows NT, skip 
to Chapter 10 now for installation information. Skip steps 5-7 below. 
Note that only the Windows NT files supplied by Trantor are 
applicable under Windows NT—all other Trantor drivers and utilities 
are not used with Windows NT operating system. 


03> Ifyou plan to use your Trantor SCSI adapter under Novell NetWare 
v3.11 or later, skip to Chapter I now for installation information. Skip 
steps 5-7 below. Note that only the NLM files supplied by Trantor are 
applicable under Novell NetWare v3.11 or later operating system—all 
other Trantor drivers and utilities are not used with NetWare. 


13 


0 
=s 
6 
mt 
”N 
ae 
= 
= 
| eh} 
=; 
ig’ 
2) 


A 
<D) 
‘> 
pa 
o wm 
oad 
a) 
an 
A 
o 
> 
o wm 
Yumi 
a) 


Chronic: User Guide 


5 


14 


Install CD-ROM, hard disk, and/or scanner software by typing 
INSTALL at the DOS prompt. Follow the on-screen instructions. 
After the installation process is complete reboot your computer to 
activate the SCSI software driver(s) and utility software. 

Run the SCSITEST program to test the installation and run the 


INSTALL program again, if necessary, to reconfigure system options. 


Install the appropriate ASPI-compatible scanner application for your 
HP ScanJet scanner; install the Tape Mate IT software (see Chapter 
15) or use any other ASPI tape backup application. 


q 


VyrVVyrIyvuy 


Pyvyrywryvyrydy 


— 4 Software Installation S 
_ é 
on An automatic software installation program (called INSTALL) is included ae 
= on the software distribution diskette #1 and allows you to install and = 
rm, configure hard disk, CD-ROM, and scanner support software. You must — 
. install your software onto a bootable hard disk. The original distribution c. 
— diskette is not copy-protected, and we encourage you to make one (1) a 
. backup copy of the original diskette (using the DOS command 
DISKCOPY or any other suitable utility) to protect against loss of or 
ji damage to your original software. 
— If there isa READ.ME text file on your Trantor distribution diskette #1, 
a please read it now with any word processor or text editor. It may contain 
corrections or updates to the software or this manual. Please see Chapter 12 


for troubleshooting assistance. 


= 4.1 Installation Steps 


Prior to installing your software, the hardware installation should have 


_ been completed following instructions contained in the Hardware 
— Installation Guide or other instructions supplied with your host adapter. 
ce Make sure that you have: 

= Q) Installed the SCSI host adapter. 


ale Q) Attached the SCSI device(s) you intend to use. 
| CY Checked that the last (or only) SCSI device is properly terminated, 


per manufacturer’s instructions. 


ae CY Checked that the device addresses of multiple SCSI devices are 
unique. 
— () Turned on the SCSI device(s) and your computer. 


The automatic installation program, INSTALL, performs the following 
tasks: 


¢ Creates a subdirectory (\TSCSI), if necessary, on the hard drive 
specified by you during installation. 

¢ Copies all the hard disk, CD-ROM, and/or scanner files to the new 
subdirectory; for Trantor adapters, copies the appropriate ASPI 
manager. 

¢ Adds the lines DEVICE=C:\TSCSI\TSCSLSYS for hard disks, 
DEVICE=C:\TSCSI\TSLCDR.SYS for CD-ROMs, and 
DEVICE=C:\TSCSITSJILSYS for scanners to your CONFIG.SYS 
file. Adds C:\TSCSI to the PATH statement in your 
AUTOEXEC.BAT file. This assumes that you specified drive C for 
the installation. CONFIG.SYS, AUTOEXEC.BAT, and the PATH 
statement are created if they do not already exist. 


J 


15 


A 
Y 
er 
= 
= 
= 
et 
i?) 
o 
> 
o wm 
yum 
2 


SC Shorts! User Guide 


4.1.1 Running the INSTALL Program 


To run the automatic installation program, place the distribution diskette 


#1 (or, preferably, a copy of it) into floppy disk drive A or B. Log onto the 
floppy drive and enter the command INSTALL. Here’s an example of this 


sequence, 


Bs 
INSTALL 


The INSTALL program is described here in consecutive order. Since the 
hard disk, CD-ROM, and scanner driver installations are very similar, the 
installation is described once, identifying where differences are in screens 
and options. The following is a basic outline of the process: 


¢ Selecting the Driver 

e Selecting the Host Adapter 
¢ Selecting the Boot Drive 

¢ Completing the Installation 


Selecting the Driver 


INSTALL’s main menu should appear (Figure 2). You may select any of 
the three options by using the [Spacebar] or [Arrow] keys to move the 
highlight cursor. 


SCSIuorks! 


Install Hard Disk Driver 


Install CDROM Driver 
Install Scanner Driver 
Exit to DOS 


1.2 Install 


Press Enter to install software for re-uriteable drives. 


Figure 2 SCSiworks! Install Main Menu 
Choose Install Hard Disk Driver, Install CD-ROM Driver, or Install 


Scanner Driver to proceed. 


For hard disk installation—after selecting the hard disk driver a screen 
appears allowing you to choose from a number of options. Select 
Install Distribution Software as shown in Figure 3. (The remaining 
options on this screen are discussed in Chapter 5.) 


Selecting the Host Adapter 


The next screen that appears in any of the three installations is the Host 
Adapter Options Screen that allows you to manually or automatically set 
your host adapter (see Figure 4). 


16 


J 


TPIvrdapypryrqgidy 


3) 1 9 J 7 1 


ae 4 Software Installation 
ini SCSIuorks! Hard Disk Driver Installation 0 
ma © 
“ : 
ma 
—_ : Ses Forsat 2. 
= SCSI Drive Spanning C 
SCSI Harduare Test ot 
aa Return to Install menu = 
x o> 
Press t and $ to move highlight among items. o. 
_— Press Enter to install distribution softuare. “A 
Figure 3 Hard Disk Driver Installation Menu 
rm In most cases, you should select Automatic Search for Host Adapter and 
‘ press [Enter]. INSTALL scans the system, identifies the adapter, and sets 
rm the adapter settings. Once the host adapter option has been set, move the 
ee cursor to Continue Installation and press [Enter]. 
me i SCSIuorks! Hard Disk Driver Installation ————=}] 
Host Adapter Options 
— 
ee Continue Installation 
Trantor Host Adapter: 
eas Trantor Host Adapter Interrupt: 
al 
_ Press f and | to move highlight among itens. 
a Press Enter to find the host adapter present. 
Figure 4 Host Adapter Options Screen 
— 8 The only reason you might want to set the adapter manually (with the 
[Left Arrow] and [Right Arrow] keys) is if you do not have your adapter 
am installed and connected to a SCSI device at this time, or if you already have 
another adapter installed in your computer—INSTALL only automatically 
ve identifies the first adapter it finds. The INSTALL program displays a help 
es line at the bottom of the screen to assist you in selecting the driver for your 
om device. 
me, |S When selecting the host adapter manually, an additional help line may 
appear at the bottom of the screen to assist you in selecting the your host 
adapter. 
al 
NOTE 
c= For adapters not listed, choose NONE, or let the automatic install option 
cs choose it for you. The INSTALL program does not install an ASPI 
manager for non-Trantor adapters, since one should be already supplied 
oe by your hardware manufacturer; but it does install the device driver(s) as 
the last lines in your CONFIG.SYS file. 
rome 
17 


H 
) 
~ 
—= 
eo) 
_ 
en 
7 2] 
o 
> 
o um 
tom 
a) 


SC Shore: User Guide 


For CD-ROM installation—once you have selected the host adapter, the 
MSCDEX Options Screen appears as shown in see Figure 5. The 
various options on this screen relate to operation of the MSCDEX 
extensions software for CD-ROM drives. For a full explanation of each 
of these options, please refer to Section 6.1 which discusses MSCDEX 
in detail. 


{-——— SCSIuorks! CD-ROM Driver Installation ————>>}] 
MSCDEX Options 


Proceed with Installation 
Restore Default Settings 
Abort Installation 


CD-ROM Device Driver Nane ¢€/D>: TSLCD 
First CD-ROM Drive Letter ¢(/L): Default 
Number of 2K CD-ROM Buffers (AD: 108 
EMS for MSCDEX ¢/E): No 
Kanji Character Set ¢/K>: No 
Verbose Sign-on Messages €/U): No 


Press f and | to move highlight among itens. 
Press Enter to proceed with installation. 


Figure5 MSCDEX Options Menu 


You may point to any of the menu options with the [Up Arrow] and 
[Down Arrow] keys; the help line at the bottom of the screen explains 
how to change each option. In most cases, accepting the default 
installation options is appropriate. Once you have set all the options, 
select Proceed with Installation and press [Enter] to continue. 


For scanner installation—once you have selected the host adapter, the 
Scanner Options menu appears. The only scanner selection on this 
screen is HPSCANNER, select Continue Installation and press [Enter] 
as shown 


in Figure 6. 


{> _ ScSIuorks! Scanner Driver Installation —"——-] 
Scanner Options 


Continue Installation 


Scanner: HPSCANNER 


Press ft and $ to move highlight among itens. 


Press Enter to Continue Installation. 


Figure6 Scanner Options 


18 


1)9d7171é=23 


Y3 713121 21 


1] 


J 


1: 3 71721 7 


os 


J] 


4. Software Installation 


Selecting the Boot Drive 

At the next screen (when installing hard disk, CD-ROM, or scanner 
drivers), INSTALL prompts you for the drive letter of your boot disk as 
shown in Figure 7. Specify your boot drive and press [Enter]. 


f= SCSIuorks! Hard Disk Driver Installation ==" 
Boot Drive 


Which drive is your boot drive? iJ 


Press Esc to return to Hard Disk Driver Installation menu. 
Press Enter to continue. 
Press * and ¢« to select a drive letter. 


Figure 7 Boot Drive Selection Screen 


Completing the Installation 


INSTALL then presents a summary Installation Options Confirmation 
Screen showing you exactly what will occur during installation (Figure 8). 


Check this screen very carefully to understand what INSTALL will do; you 
have the option at this point of backing up to change any of the option 
settings by pressing [Escape]. 


i SCSIuorks! Hard Disk Driver Installation ==] 
Installation Options 
The following options have been selected for your installation: 


Creating new directory C:\TSCSI. 
Copying all the required files to C:\TSCSIN. 


Backups for CONFIG.SYS and AUTOEXEC.BAT will be stored in 
CONFIG.HD and AUTOEXEC.HD respectively. 


Rdding the following to your C:\CONFIG.SYS file: 
Device-C: \TSCSINMALSB.SYS Cuith interrupt = Disabled) 
Device=-C: \ISCSINTSCSI. SYS 

Adding the following to your C:\AUTOEXEC.BAT file: 
path C:=\TSCSIN Cif needed 


Press any key to install on drive C: with the above options. 
Press Esc to abort installation and return to 
Hard Disk Driver Installation menu. 


Figure 8 _ Installation Options Screen 


Press any key to proceed with the installation. If you proceed, you should 
see a screen similar to Figure 9as INSTALL creates (if necessary) the 

\TSCSI subdirectory on your boot disk and copies the device distribution 
files into it. In addition, your CONFIG.SYS and AUTOEXEC.BAT files 


are modified (or created, if necessary) to load the device software. 


19 


0 
= 
= 
a’) 
=t 
Dn. 
me 
S 
jena, 
= 
jana 0 
Oo 
17 2) 


i? 9] 
Y 
eo) 
© wm 
i 
=) 
a 
i?) 
o 
> 
© wm 
a 
a) 


SC Shots User Guide 


When INSTALL has completed the installation, the statement 
“Installation Completed” appears at the bottom of the screen, as shown 
in Figure 9. 


f= :«“SCSIuorks! Hard Disk Driver Installation ————] 
Installing Software 

Copying b: \TODOS4. EXE -—> C: \TSCSINTODOS4. EXE. 

Copying b:\TSPAN. EXE -> C:\TSCSINTSPAN. EXE. 

Copying b: \TSTATUS. EXE -> C: \TSCSINTSTATUS. EXE. 

Copying b:\TUNLOCK. EXE -> C: \TSCSINTUNLOCK. EXE. 

Copying C:\CONFIG.SYS —> C:\CONFIG. HD. 

Copying C:\AUTOEXEC. BAT -> C: \AUTOEXEC. HD. 

Opening C:\CONFIG.SYS file. 

Old driver MA13B.SYS updated. 

Old driver TSCSI.SYS updated. 

Copying b:\TSCSI.SYS -> C:\TSCSINTSCSI. SYS. 

Checking Lastdrive statenent in CONFIG.SYS file. 

Adding Lastdrive=F command in CONFIG.SYS File. 

Closing C:\CONFIG.SYS file. 

Opening C: \AUTOEXEC. BAT file. 

Checking Path=c:\tsesi in C: \AUTOEXEC. BAT. 

Closing C:\AUTOEXEC. BAT file. 


Installation Completed. 
Please reboot the computer for the installation to take effect. 
Press any key to return to Hard Disk Driver Installation menu. 


Figure 9 Installation Complete Screen 


Press any key to return to the INSTALL main menu. At the main menu 
you may choose to install other device software or return to DOS. When 
you are finished installing the software, reboot your computer (by pressing 


the [Ctrl]-[Alt]-[Del] keys simultaneously) to activate the software. 


NOTE 
Once you have configured and installed your software, the main INSTALL 
program is no longer used. You may reconfigure your CD-ROM, hard 
disk, and/or scanner software at any time by running the appropriate 
installation program (HDINSTAL, CDINSTAL, or SCINSTAL) from the 
directory containing your installed hard disk, CD-ROM, and/or scanner 
software. 


4.1.2 __ Checking the Installation 


If the installation process was completed correctly, your computer should 
operate as before, except that the software (MAxxx.SYS, TSLCDR.SYS, 
TSJILSYS, and/or TSCSI.SYS—all loaded via your CONFIG.SYS file) 
should now recognize and use the host adapter and any SCSI device(s) 
attached to it. (Full DOS access to hard disk type devices may require 
formatting first, see Chapter 5 for details.) 


During bootup, you should see information appear on your screen as the 
software searches for and recognizes the host adapter and your SCSI 
device(s). 


20 


J 


™ 
al 


Jj) fo] 


J 


i 


4 Software Installation 


As each device is found, information about the device appears on screen. If 
MAxxx.SYS, TSLCDR.SYS, TSCSLSYS, TSJII.SYS, and/or MSCDEX 
report any problems, check the following: 


¢ Make sure the hardware is installed and cabled correctly (see 
hardware documentation). 

° Make sure the SCSI software has been installed properly (Section 
4.1.1). Run SCSITEST (see the next section) to make sure the 
system can recognize the SCSI device(s). 


¢ Make sure your SCSI device(s) is plugged in and turned ON! 


4.1.3 Testing the SCSI Hardware 


If there appears to be a problem accessing the SCSI device(s) attached to 
your computer, or if you simply want to verify proper operation of your 
SCSI hardware, you can use the test software (called SCSITEST). There 
are two ways to run SCSITEST,, either within the INSTALL menu system 
(by selecting SCSI Hardware Test), or in a “stand-alone” mode directly 
from DOS. The program’s operation are the same in either case—the 
choice is yours. 


Starting the Test Software in Stand-Alone Mode 


To invoke the test software (SCSITEST), from the DOS prompt log onto 
the \TSCSI subdirectory and type SCSITEST. For example: 


Cs 
CD\TSCSI 
SCSITEST 


Ss 
ae 
6 
= 
2) 
— 
= 
aks 
unt 0 
co. 
ig") 
“A 


After running SCSITEST, you should see the opening screen (Figure 10). 
Select Test Hardware and press [Enter]. After a moment, SCSITEST 
should confirm that an adapter is connected to the system. 


SCSI Test 


SCSI Test - SCSI Hardware Test Progran 
Revision 1.20 July 24, 1998 
Copyright (C> 1988-93, Trantor Systems Ltd. 


Main Menu 


Test Harduare 


View Test Setup 


Return to DOS 


Figure 10 SCSITEST Opening Screen 


21 


WD 
Y 
per 
= 
= 
es, 
an 
iF 9) 
o 
> 
ow 
amd 
a 


SC Shots: User Guide 
If SCSITEST Indicates an Error 


If SCSITEST reports a problem identifying an adapter, turn your 
computer off and recheck your installation of the host adapter. Make sure 
it is securely seated in your computer and that all connections to the 
adapter are secure. After retesting the installation, if SCSITEST still shows 
a problem identifying the adapter, contact your dealer for assistance. 


If SCSITEST Indicates a SCSI Adapter Was Found 


In most cases, SCSITEST indicates that one adapter was found and asks 
for confirmation (Figure 11). If all seems to be working properly, confirm 
this by answering ¥ to the question. SCSITEST then proceeds to an 
informational screen, telling you that a scan for SCSI devices will now take 
place. 


NOTE 
The ASPI manager must be loaded before SCSITEST can function. Be 
sure you have installed the appropriate driver(s) and rebooted your 
system. When the system is rebooting watch the screen to see if the 
ASPI manager has successfully installed. 


SCSI Test 


SCSI Test - SCSI Harduare Test Program 
Revision 1.28 July 24, 1990 
Copyright <C) 1988-93, Trantor Systems Ltd. 


Test in Progress 
SCSI Host Adapter Test - Pass 1 


This test scans for the presence 
of properly installed SCSI host adapters. 
This test will NOT find SCSI adapters 
from other manufacturers. 


1 SCSI host adapter found. 
Is this the number of host adapters installed ¢y, n>? 


Figure 11 SCSITEST Adapter Board Count 


After reading the information presented, press [Enter] to begin the scan 
(“polling”) for devices. Polling begins with device 0 and proceeds through 
device 6. If you have more than one SCSI device connected (such as a hard 
disk, removable-cartridge, CD-ROM, or scanner drive), make certain that 
their device addresses are different (see your hardware documentation). As 
each device is found, SCSITEST pauses to identify the device and its 
address. After making sure the information provided is correct, press 
[Enter] to continue. 


22 


q ;| q J 4s J J 


17 3 


j 


j 


1) 


j 


J 


4 Software Installation 
If No Devices Are Found 


If SCSITEST cannot identify any devices connected to the adapter, it stops 
and informs you of this problem. In most cases, the reason for a device not 
being found is one of the following: 


¢ The device is not connected to the adapter correctly. Double- 
check that the cable between the adapter and the SCSI device(s) is 
correctly attached. 

e The device is not receiving power. Check that a power cable is 
properly attached to the SCSI device. 

e The device address is not set properly. Check that the device address 
is set between 0 and 6 (see your device manual for details) and, if 
you are using more than one SCSI device, that each device is set to a 
different address. 

¢ The ASPI manager (MAxxx.SYS or another name for other 
hardware manufacturers) is not loaded. 


After checking the above conditions, re-run SCSITEST. If SCSITEST still 
indicates that it cannot identify any devices, contact your dealer for 
assistance. If SCSITEST correctly detects the presence of the adapter and 


cannot identify any devices, the most likely remaining problem is either a 


bad connecting cable or failure of the SCSI device. 


Test Summary 

After testing for the presence of the host adapter(s) and SCSI device(s), you 
may select View Test Setup from the SCSITEST menu. This short 
summary screen (Figure 12) indicates whether an adapter was found during 
the test and, if so, its address. 


SCSI Test 


SCSI Test - SCSI Hardware Test Progran 
Revision 1.20 July 24, 1999 
Copyright (C> 1988-92, Trantor Systems Ltd. 


23 


lo) 
me 
< 
om 
a 
D 
— 
Cc 
ome 
= 
pa 
ge 
a’ 
wa 


7) 
w 
‘= 
= 
= 
=) 
— 
WH 
o 
> 
6 wm 
ta 
= 


SC Shvorts User Guide 


Normally, you'll see three “Failed” indications and one “OK” indication; 
the OK denotes the adapter. This summary screen does not report 
anything about the device(s) connected to the adapter; it is designed to 
summarize the condition of the adapter only. 


If everything seems to be working properly, exit SCSITEST. You should 
be able to “see” the CD-ROM(s) and hard disk drive(s) by logging to their 
drive letter in DOS. For example, if your first SCSI device has been 
assigned a drive letter D, you should be able to type D: followed by 
[Enter]. At this point, DOS recognizes the drive as it would any other 
drive, assuming it has been properly formatted (see Chapter 5). 


Note that you cannot log onto a scanner or tape device. These devices can 
only be accessed through the appropriate scanner or tape drive application 


software. 


Assuming that the hardware and software tests indicate proper operation of 
your system, proceed to Chapter 5 of this manual for a summary of the 
hard disk utilities, Chapter 6 for a summary of the CD-ROM utilities, or 
Chapter 7 for a summary of the scanner operations. 


24 


yyy} tt1tF1F99F9999 2 


|e 


5 Hard Disk Software Operation 


This section describes the function and operation of each of the TSCSI 
hard disk software utilities (which also apply to most removable-media 
devices, such as SyQuest, Bernoulli, Floptical, and magneto-optical drives). 
Although you might need some of these programs only infrequently, it is 
suggested that you familiarize yourself with them now so that you will 
understand their capabilities when needed. 


Ss 
o. 
a 
Lar} 
7) 
ae 
S 
= 
jamie 
o~* 
jms @ 
& 


This manual does not address any of the standard DOS commands, such 
as DIR, DEL, COPY, etc. Your software and hardware in most cases 
permits the use of these DOS commands with your SCSI hard disk 
device(s) in exactly the same way as with your other hardware (except 
CD-ROM drives; see Chapter 6). If you are unfamiliar with these, consult 


your DOS documentation or dealer for assistance. 


5.1 _TFORMAT (Formats Storage Media) 

TFORMAT is designed to format or prepare the storage media of your 
SCSI hard disk devices in the same manner as the FORMAT command 
used by DOS. It works with any erasable SCSI device compatible with the 
host adapter including hard disks, SCSI floppy drives, magneto-optical, 
and removable-media cartridge drives (such as the Bernoulli drive). Note 
that the ASPI manager (MAxxx.SYS) must be installed and loaded before 
TFORMAT works; this is normally set up automatically during software 
installation (Chapter 4). 


In all cases, the operation of TFORMAT is the same; just run TRORMAT 
from DOS, but do not specify a drive letter to format (as you normally 
would with the DOS FORMAT command). (You may also run this 
program from the Hard Disk Driver Installation menu by selecting SCSI 
Format, see Figure 8). For example, to “poll” your adapter and the SCSI 
device(s) in your system and present you the option of which device to 
format in SCSI address number order, enter: 


TFORMAT 


Figure 13, for example, illustrates the case of a single device (SCSI address 
4) being found; a SyQuest 44-MB removable-cartridge drive. 


025 Ifyou are formatting a cartridge in a dual-drive Bernoulli drive, you must 
perform the format operation in the first (usually the left) drive. 


TFORMAT asks you to confirm whether you wish to format this device; 
you must type YES (upper or lower case), followed by [Enter] to proceed 
with the formatting. Type anything else to abort the formatting operation. 
When more than one drive is daisy-chained to the adapter, the format 


25 


CS droris User Guide io 


TFORMAT: Generic SCSI Format Program. Version 1.32 
Copyright <C> 1988-89, Trantor Systens Ltd. 


J 


i? a) 
Dy 
per 
— 
eo 
_ 
ne 
i?) 
o 
> 
© wu 
= 
an 


Card Address: 328H, SCSI Device Address: 4 


Device vendor: SyQuest 
Device name: $9555 


Is this the drive you would like to format? 
Type *yes’ to confirm or anything else to abort: 


Polling (328, Syfuest $9555 
Figure 13 Opening TFORMAT Screen 


program shows you the SCSI address and the vendor information of the 
next drive and allows you to either select the drive by typing YES or 
proceed to the next one. 


O35 Care must be taken when more than one device from the same vendor is 
connected to the adapter as the same vendor name appears on screen but 


with a different SCSI device address. 
After confirming that you wish to proceed with the format, TFORMAT 


displays the technical characteristics of the drive and pauses to wait for a 
key to be pressed. 


BS At this time, if you typed TFORMAT /L or if your drive has not been 
low-level formatted, the following will happen: TFORMAT asks if you 
wish to do a low-level format. A low-level format is a complete total erasure 
of the entire disk surface and usually must be done once on brand-new 
media. This format is in contrast to a high-level format which only erases 
the drive’s subdirectory and file directory information. In most cases, a 
high-level format is sufficient to clear out all data from the drive and is 
much faster than a low-level format. 


If you elect to perform a low-level format, TFORMAT asks you to supply 
an interleave value (enter 0 to use the drive’s default interleave value, unless 
otherwise instructed by your dealer) and to confirm that you really want to 
destroy all data on the device. It then proceeds with the low-level format. 


7779199 7991379 39 39 39 39 39 39 7 8 


26 


J 


boi] 


] 


| 5 Hard Disk Software Operation 


WARNING 
If you do not want anyone to retrieve your data, you should perform a 
low-level format on the media. A DEL command issued from DOS, ora 
high-level format, is no guarantee that data is irretrievably erased. Given 
a moderate level of knowledge, it is possible to “unerase” data under 
these circumstances. A low-level format erases data for good and should 
be used in sensitive circumstances. For government-classified data, even 
this is probably not sufficient; seek assistance if you have any doubts. 
This potential for unerasure is true of any DOS device, not just SCS! 
devices. 


|S) 
mt 
= 
O 
mt 
72) 
ae 
s 
jm @ 
= 
co. 
O 
“A 


TFORMAT asks if you wish to do a high-level format. At this point, you 
will “partition” the drive (assignment of one or more drive letters to one 
device). For instance, with a large hard disk, you might wish to assign both 
a D drive and an E drive to divide up the large capacity; these are 
considered multiple “partitions” of a device. TFORMAT gives you the 
option of using one or more partitions (up to four partitions per physical 
device) in the high-level format routine. 


If you choose to perform a high-level format, you'll see a screen similar to 


that in Figure 14. 


TFORMAT: Generic SCSI Format Program. Version 1.38 
Copyright <C> 1988, Trantor Systems Ltd. 


Total Partitions 1 
SCYL ECYL BOOT TYPE SCYL ECYL BOOT TYPE 
2. 


349 +N FAT12 


Options: 
SCingle) Partition. 
TCuo>) Partitons CA small one for booting and the remainder) 
CCustom Partitioning. 
Qcuit>. 
Selection - 


Polling (328, 4) SyQuest SO5S5 
Figure 14 TFORMAT High-Level Format Options 


Here you have the option of setting up single or multiple partitions. In 
general, for floppy drives or hard/cartridge drives smaller than 32 MB, a 
single partition should be used for convenience. For large drives, you may 
create multiple partitions of any size you wish, except that if you wish to 


27 


ve) 
Vv 
= 
— 
c= 
_ 
—_— 
y,) 
© 
a 
tn 
 . 


SCShrots User Guide 


make a drive bootable, the first partition should be no larger than 
2 MB nf ith restriction 


version 3, the first bootable partition must be no larger than 32 MB). 


NOTE 

In order to create a partition larger than 32 MB, your system must be 
running DOS version 3.3 or later. Earlier versions of DOS limit you to a 
maximum of four partitions per physical disk drive, with each partition a 
maximum of 32 MB. Under DOS 3.3, the SCSI device sector size begins 
at 512 bytes for up to a 32-MB partition and doubles with each doubling 
of partition size, due to the requirements of DOS. For instance, a 64-MB 
partition would use 1-KB sectors, a 128-MB partition would use 2-KB 
sectors, etc. Therefore, if you wish to store a large number of small files, 
keeping each partition size (and therefore, the sector size) small would be 
the best arrangement. DOS version hav ch limitati 

Z 


One of the options which are presented for drives larger than 32 MB is 
“T(wo)” partitions, which on a hard disk creates a small partition for 
bootup and another large partition with the rest of the drive’s capacity. 
This offers a couple of advantages: it protects your data by keeping the 
bootup information in a separate partition (away from your data partition) 
in the event of a problem with the drive, and it allows you to have all the 
advantages of one very large drive (which exceeds DOS 3.x’s normal 
capabilities) while tying up only the minimum amount of disk space 
necessary for booting. 


Another option is a custom partitioning which allows you to specify exactly 
how many (up to four) partitions you wish to have and how large they 
should be. The size is specified in cylinders, which is a measure of the 
drive’s capacity. For instance, if a drive has 430 cylinders (TFORMAT tells 
you this information), and you wish to have two equal-sized partitions, you 
would specify the first partition to be from cylinders 0-215 and the second 
partition from 216-429 (cylinder counts start from 0). You may use any 
combination of cylinders you wish to define your partitions. 


After you choose the type of partitioning you wish to use, TFORMAT asks 
if you wish to verify the partitions. Verification is the process of examining 
each storage sector on the drive to make sure that it reliably stores data. It 
is a good idea, especially if the media is new, to run the verification process 
(which “locks out” any bad areas), but it does take time to perform this 
operation. If you are just repartitioning the drive, and you are sure the 
media is in good shape, verification may not be necessary. 


After you finish specifying your choices, TFORMAT reminds you that 
repartitioning destroys all data on the drive. After confirming this, 
TFORMAT proceeds with the partitioning (and verification, if requested), 


28 


9} 9 3 9 9 J DF Fd 9d! 


jo) 


5 Hard Disk Software Operation 


informing you of its progress. Upon completion, TFORMAT reminds you 
that a reboot of your computer (and possible installation of the software) 
may be necessary. This completes TFORMAT’s operation. 


5.2 __TSPAN (Span One Partition Over Several Drives) 


TSPAN allows you to create a single large logical drive from two or more 
erasable SCSI devices by combining or “spanning” them under software 
control. These devices do not need to be identical, however, they must be 
either all fixed or all removable devices. It is possible to span, for instance, 
two 40 MB cartridge drives to create a single 80 MB removable ‘drive.’ 
Note that the ASPI manager (MAxxx.SYS) must be installed and loaded 
before TSPAN works; this is normally set up automatically during software 
installation (see Chapter 4). 


oO 
= 
= 
‘o) 
Lar} 
i) 
— 
= 
a 
| el) 
S. 
¢) 
2) 


TSPAN uses the entire SCSI device, no matter how many partitions you 
have previously created on it. Partitions are eliminated and the whole drive 
becomes part of the newly spanned logical drive. Prior to running TSPAN, 
TFORMAT must be run with at least one partition defined in each drive 
that is going to become part of the spanned set. TSPAN can be run from 
the HDINSTAL menu by choosing SCSI Drive Spanning option, see 
Figure 8. It can also be run from DOS by typing TSPAN at the DOS 


command line. 


For example, to poll all the devices attached to your SCSI card(s) and gives 
you a menu (Figure 15) of available SCSI devices listed by drive #, SCSI 
address, capacity, and drive type (fixed or removable), enter: 


TSPAN 


Select in turn the Drive Number of each device you wish to span into a 
single partition and press [Enter] to continue. 


NOTE 


Spanning a device erases all the information on the device! 


After confirming that spanning the drives destroys all the data on them, 
you have the option of doing a surface verify of your spanned drive. If you 
chose to verify, each sector on your drives is evaluated and TSPAN “locks 
out” any bad areas on your disk to prevent data from being written there. 
This process takes some time, especially on large drives. This step must be 
done even if the drives had been verified after they were formatted with 
TFORMAT, just to make sure that the spanned partitions are correctly 
established. Therefore, to speed up the installation, skip the verify step in 
TFORMAT for those drives that you intend to combine in a spanned 
volume. 


29 


Chios User Guide 


TSPAN: Build Spanned Volume Record. Version 1.08 
Copyright (C> 1988-89, Trantor Systems Ltd. 


Drut# SCSI ADRS Capacity DrvType Drvf SCSI ADRS Capacity DrvuType 
1. 328H,0 18.2MB Remavable 2. 328H,4 42.3NB Removable 


i? 2) 
UY 
« wl 
_ 
Lo | 
: 
‘S 
— 
= 
a) 
o 
> 
oom 
a 


Select Drv# to combine or press return to terminate: 


Figure 15 TSPAN List of Available Drives 


TSPAN notifies you that it is initializing the Spanned Drive, clearing the 
FATs (File Allocation Tables) and Directory and then either proceeding to 
verify the data or exiting the program. You must reboot your system to 
make the new spanned drive available. 


5.3___ TSTATUS (Checks Status of Your System) 


If you have installed the hard disk driver, TSTATUS gives you a simple 
summary screen (Figure 16) of the version of TSCSI.SYS loaded in 
memory, how many bytes of memory it uses, and the drive letters and 
capacity of SCSI devices currently active on your system. 


TSTATUS is a useful utility to run anytime, but it is a good idea to run it 
immediately after installing or changing any of your hardware or software 
configuration settings, just to make sure that your SCSI equipment is 
operating as you expect. 


ts TSTATUS does not apply for CD-ROM, scanner, or tape drive 


installations. 


30 


jj) J 


9} 3  F F 2 FO 9 Gd 


d 


5 Hard Disk Software Operation 


SCSI Status 
SCSI Driver Status Utility 


Version 1.38 November 23, 1988 
Copyright <C>) 1988, Trantor Systems Ltd. 


Current Driver Status 


san[B()\S19A1Iq 


Revision 4.68 of the SCSI driver is loaded. 
The driver occupies 13528 bytes of memory. 


Drive L, Removable Media 42. 3B 


Press any key to continue. 


Figure 16 TSTATUS Summary Screen 


31 


ff €£ € € Eee tC ete ££ e€ € cE PEt eet eg 


! User Guide 


32 


SoM) \s19A1I 


6 CD-ROM Software Operation 


This chapter describes the function and operation of the CD-ROM 
software utilities. Although you might need these programs only 
infrequently, it is suggested that you familiarize yourself with them now, so 
that you will understand their capabilities when needed. 


This manual does not address any of the standard DOS commands, such 
as DIR, DEL, COPY, etc. Your software and hardware, in most cases, 
permits the use of these DOS commands with your SCSI device(s) in 
exactly the same way as with your other hardware (CD-ROM drives do 
not permit you to delete files from or copy files to the CD-ROM disc). If 
you are unfamiliar with these, consult your DOS documentation or dealer 
for assistance. 


6.1 _MSCDEX, the DOS CD-ROM Extensions 


Your DOS operating system by itself does not know how to access a 
CD-ROM drive. There are many differences between a CD-ROM and 
either hard or floppy drives. For example: 


e CD-ROMs are read-only media; data cannot be added to or deleted 
from a CD-ROM disc. 
¢ CD-ROM drives can hold up to 680 MB of data—many 


DOS versions (prior to 4.x) cannot handle partitions greater than 32 


s 
me 
a 
=} 
“A 
— 
5 
poet, 
ht 3 
c. 
oO 
7) 


e CD-ROM drives use the High Sierra or ISO 9660 file 
formats—DOS drives use the MS-DOS format. 

¢ CD-ROM drives do not include a FAT (File Allocation Table). 

¢ CD-ROM drive sector size is 2048 bytes. IBM PC/XT/AT-type 
floppy and hard disks typically use a sector size of 512 bytes. 


Due to these differences, CHKDSK, FORMAT, and some other DOS file 
utilities do not work on a CD-ROM drive. 


The MSCDEX program is a memory-resident extension to DOS which 
interfaces your operating system to your SCSI CD-ROM device driver 
(TSLCDR.SYS) and your CD-ROM drive. 


MSCDEX is provided by Trantor under license from Microsoft. Please 
complete and return your Microsoft MSCDEX registration card! 


After the TSLCDR.SYS device driver is successfully loaded (via your 
CONFIG.SYS file), MSCDEX must be executed. It is common to load it 
through your AUTOEXEC.BAT file. You could also run it only when you 


33 


i? a) 
By 
‘D 
oad 
~~ 
— 
ae 
A 
oD 
> 
o ym 
Jon 
a) 


GC Shots: User Guide 


first need access to your CD-ROM drive during a work session. The 
INSTALL program normally sets up your AUTOEXEC.BAT file to 
automatically load MSCDEX. 


The format of the MSCDEX program in the AUTOEXEC.BAT file is as 


follows: 


MSCDEX [/V /K /E] /D: [DriverName] 
/L: [DriveLetter] /M: [Value] 


Where: 


/D:[DriverName]—is a required parameter and gives MSCDEX the 
name of the device driver it uses to “talk to” the CD-ROM drive. The 
internal name of TSLCDR.SYS is TSLCD and should be substituted 


for [DriverName]. 


/L:[DriveLetter]—tells MSCDEX to assign [DriveLetter] as the 
logical device drive name to the CD-ROM. When more than one 
CD-ROM is present, the drive letters are sequentially assigned starting 
with [DriveLetter]. If no /L: parameter is supplied, MSCDEX assigns 
the next available drive letter. 


[35° If you have a total of more than five logical drives on your system (drives 


A-E), you must prepare DOS to support at least the number of devices 
you have, via the DOS LASTDRIVE statement. In your CONFIG.SYS 


file, you must insert a line like this: 
LASTDRIVE= [DriveLetter] 
Where: 


[DriveLetter]—is the alphabetic character (F through Z) that represents 
the last valid drive letter that DOS may use. For example: 


LASTDRIVE=H 


/M:[value]—tells MSCDEX how much memory to allocate as sector 
buffers for caching CD-ROM information. The higher this value is, the 
better performance is, though you use additional RAM for each buffer 
that is allocated. If no /M: parameter is supplied, MSCDEX allocates 
ten buffers, each of which uses 2048 bytes of RAM memory. 


/V—This option results in a verbose listing of additional information, 
including how much memory is used by buffers, resident data, and 
resident code. 


/K—This option is used only when the CD-ROM media directory is 
written in Kanji (Japanese). 


34 


Se oe ee 


J 


Yo! } FT 1 3 39397997 7 


6 CD-ROM Software Operation 


/E—This option tells MSCDEX to use expanded (EMS) memory if your 
system includes it; this conserves about 16 KB of main DOS memory. 


For example, to install MSCDEX with an internal name of TSLCD, use 
expanded memory, and configure the CD-ROM drive as drive M, enter: 


MSCDEX /E /D:TSLCD /L:M 


o 
a 
6 
Lae} 
” 
a 
5 
see 
yah 
=. 
¢) 
7) 


All of the above options may be configured via the CDINSTAL program, 
either when first installing your CD-ROM software or later, should you 
decide to change the settings. See Section 4.1.1 for details of the CD-ROM 


installation programs. 


6.2 _CHKCD 


Very similar to the CHKDSK utility which is supplied with DOS, 
CHKCD displays useful information about the capacity and contents of 
your CD-ROM disc. While not required for normal operation of your 
SCSI system, it is often useful to have available. 


To run, simply type CHKCD, optionally followed by the drive letter of your 
CD-ROM and a colon. 


For example, to report information for CD-ROM drive M enter: 
CHKCD M: 


CHKCD may take a minute or two to report results, please be patient! 


6.3  TLOCK 


This utility when run from the DOS command line (or within a batch file, 
if desired) “locks” a CD-ROM disc or removable-media hard disk cartridge 
in the drive; i.e. it inhibits operation of the front-panel Eject button. This 
utility is useful on a shared or networked computer system where an 
inadvertent disc eject might disrupt operations. Some CD-ROMs, such as 
the NEC CDR-37, have manual-loading mechanisms; TLOCK has no 


effect on such drives. 


Simply type TLOCK to lock all removable-media drives currently installed, 
or follow with the drive letter to lock one drive. 


To lock only drive F, which may be any removable-media drive, for 
example enter: 


TLOCK Fs: 


35 


A 
1) 
= 
= 
es 
_ 
a 
AW 
5) 
> 
© wm 
You 
a 


GC SMiorte User Guide 


6.4 TUNLOCK 


This utility reverses the action of TLOCK, i.e. it permits media to be 
ejected from a CD-ROM or other removable-media drive, except 
additional units on multi-drive products (such as dual-drive Bernoulli 
Boxes and multi-disc CD-ROM changers). You must specify the drive 


letter for such devices. 


Type TUNLOCK to unlock all installed removable-media drives, or follow 
with the drive letter to unlock one drive. 


To unlock only drive G, for example, which may be any removable-media 


drive, enter: 


TUNLOCK G:; 


6.5 TEJECT 


This utility ejects a CD-ROM disc or removable-media hard disk cartridge 
from the drive (except, of course, for those drives which have a purely 
mechanical eject mechanism). 


03> TEJECT does not work on additional units on multi-drive products (such 


as dual-drive Bernoulli drives and multi-disc CD-ROM changers). You 


must specify the drive letter for such devices. 


If TLOCK has been run, TEJECT sets the drive to unlocked status prior 
to ejecting the disc. 


Type TEJECT to eject all installed removable-media drives, or follow with 
the drive letter to eject just one drive. 


For example, to eject only drive H (which may be any removable-media 
drive) enter: 


TEJECT Hs: 


36 


Jd 


Se ee oe ee | 


$$) 9 YF 


ee 


) 3) 9 3 7 7 YF 


em 7 Scanner Operation 0 
a er y. * 
ie 
: This chapter describes how your scanner functions with SCSIworks! ae 
software and how to use the scanner diagnostics program. = 
~ 7.1 Scanner Files ot! 
O. 
al The following is a list of scanner files found in the (SCANNER ut 
a subdirectory on software distribution diskette #1. 
— TSJII.SYS—The scanner device driver file which links the hardware to the 
: operating system. It must be loaded through your system’s 
rom, CONFIG:SYS file; INSTALL.EXE modifies your CONFIG.SYS file 
i automatically. 
asia TSJDIAG.EXE—The scanner diagnostic program that provides you with 
= information about the installed scanner and driver. It enables you to 
aaa perform a scanner self test and check communications between the 
Shee scanner and the driver. 
-— TSJ_READ.ME—A text file which may be included, containing 
in up-to-date scanner information since this manual was printed. It is 
amen important that you look for this file and, if it exists, read it carefully. 
7.2 _How Your Scanner Functions 
a Since a scanner cannot function as a _ 
drive, your operating system by itself 
im: does not know how to access it. Your 
~ scanner operates only through a 
eal compatible scanner software 
: application, see your scanner supplier 
sacs for details. 
Referring to Figure 17, you can see that 
la the scanner application works through 
#4 the scanner driver contained in the 
a SCSIworks! software package, and the 
a scanner driver accesses the scanner 
through the ASPI manager. See 
i Appendix B for a complete ASPI 
explanation. 
fame, 
_.. [RS When preparing your scanner for use, 
ae be sure to install Trantor’s scanner 
driver first (see Chapter 4), then install Figs 17. ‘Seanneriintetess 
ram Diagram 
37 


4d 


A 
Y 
_ 
= 
‘= 
as 
a 
A 
o 
> 
2 my 
onl 
Q 


WC Shrorc: User Guide 


the scanner application software. This way you can insure your scanner 
functions with your Trantor software. 


7.3___ Scanner Diagnostics 


During bootup, if an initialization error occurs, the scanner driver aborts 
and removes itself. Initialization fails if TSJILSYS cannot access an 
installed ASPI manager or cannot locate the appropriate scanner on the 
SCSI bus. Otherwise, TSJII.SYS displays a status message including the 
scanner model number and SCSI ID. 


Since you cannot use any DOS commands to check your scanner, such as 
DIR, CHDSK, etc, SCSIworks! software includes a scanner diagnostic 
program. This program enables you to perform a scanner self test and to 
check communications between the scanner and the driver; it also gives 
information about the installed scanner and driver. To execute this 
program, at the DOS command line, type: TSTDIAG. 


38 


J 


$33 9 3 7 


I 4 


ee 


q 


§ Device Driver Options 


This chapter describes command-line options (commonly called 
“switches”) for various SCSIworks! files. Normally, the defaults for these 
switches (as set during installation) work fine; these options are available 
primarily for fine-tuning and troubleshooting. We recommend that you do 
not change the default settings unless it is necessary and only if you clearly 
understand what you are doing. 


8.1 How to Identify Software Versions 


Occasionally, for technical support or other reasons, you may need to 
determine the version number of our software drivers. The version is 
shown on screen as the software loads, but you may also find it by using 
the TYPE command from your DOS command line. This process applies 
to the .SYS driver files and is performed as follows (using the CD-ROM 


driver as an example): 


TYPE TSLCDR.SYS 


8.2 Driver Support 

If you use a modem, you may get access to technical support for our 
drivers via our BBS. See Chapter 12 and the front of this manual for more 
information. 


8.3 Driver Command Line Switches 


The following lists command line parameters or switches. These 
parameters can be used as startup options shown in the format /Xn, where 
X is the command line switch, and n is the option passed to it. 


oO 
ae 
6 
=? 
7 4) 
— 
- 
oS. 
—e 
o> 
a © 
om 
i?) 


These parameters can be listed directly after their appropriate file name in 
CONFIG.SYS. For example, the line in CONFIG.SYS for the hard disk 


driver could read: 
DEVICE = C:\TSCSI\TSCSI.SYS /I5/W3 


This sets the driver for IRQ5 and “no wait” if the driver doesn’t find a 
device. 


ASPI manager (MAxxx.SYS) 


/In_ Sets the interrupt channel; for example, 3, 5, or 7. Be sure 
to set the jumpers on the adapter to match the interrupt channel. 


/IPn Sets the IRQ value to be returned to WINASPI.DLL by the ASPI 


manager. 


39 


i") 
cD) 
= 
© wma 
z= 
—_ 
— 
i? a) 
o 
> 
ou 
Semel 
= 


A 


SC Shrois: User Guide 


A\Nee 


We] 


/Wn Pause (warning) mode 
Pause for a key to be pressed if no SCSI device is detected 


(default). 
2 Pause for a key to be pressed if SCSI device is detected. 
3 Do not pause at all; useful if you often boot with no 


SCSI devices connected. 


aN ; ; i — p hNT f t\ 
((MA348.SYS)) (iyi? etl e LONER 
ee 


/Min-—Mode configuration switch. Default is 00. Some parallel ports 
require additional delays to the read and write cycles of the device. 
The amount of additional time the T358 MiniSCSI™ Plus adapter 
read and write cycles are delayed is controlled by the value of n. 


n may be set to any value between 0 to 7. 
0 (the default) inserts no cycle delays (runs at highest 
; throughput rate). 
ANS 7 adds 875 ns of delay to the MiniSCSI Plus adapter read 


for WO wingnd write cycles 


MA358.SYS 


40 


/Mnm Mode configuration switch. Default is 00. Some parallel ports 
require additional delays to the read and write cycles of the device. 
2.n 


The amount of additional time the T358 MiniSCSI EPP adapter 
read and write cycles are delayed is controlled by the value of n. 


n may be set to any value between 0 to 7 as shown below: 
(the default) inserts no cycle delays (runs at highest 
throughput rate). 


oS 


7 adds 875 ns of delay to the MiniSCSI EPP adapter read 


and write cycles. 


Allowable values form . 

0 Auto-port detect (default). 

2 Force unidirectional. 

4 Force non-EPP; auto detect unidirectional or bidirectional. 
6 Force non-EPP and force unidirectional. 

8 Force EPP. 


1) 3 @ § 199 9 9 T 7 


J 


13 7 


Jyoy39 377 J 


| 


8 Device Driver Options 


ISCSI.SYS 


/An 


/Kn 


/R 
/Un 


/Wn 


Allocates a particular maximum sector size under DOS 3.x. Used 
with removable media. The default is to recognize standard 32 MB 
or smaller partitions. Larger partitions can be allocated as follows, 
where the number n indicates the sector size in Kilobytes (KB): 

1 32 MB-64 MB partitions. 

2 64 MB-128 MB partitions. 

4 128 MB-256 MB partitions. 

8 256 MB-512 MB partitions. 

16 512 MB—1 GB partitions. 


Ss 
ae 
a 
Lae | 
7) 
—— 
= 
= 
cot 
p= @ 
oO 
7) 


Reserves drives to prevent “phantom” drives. When booting from 
a non-Trantor SCSI adapter, both the ROM and the Trantor 
software driver manage the SCSI device, creating a “phantom” 
drive. This feature forces the ASPI driver to ignore devices 
managed by the ROM. n indicates the number of drives the 
driver should ignore. 


Sends a RESET command to the SCSI bus before the driver loads. 


Restrict maximum number of Logical Units (LUNs) available. 
Useful when a device has multiple logical units that are not all 
being used. This allows you to select, for instance, only the first 
three LUNs and ignore the others. 


Pause (warning) mode. 

0 Pause for a key to be pressed if no SCSI device is detected 
(default). 

2 Pause for a key to be pressed if SCSI device is detected. 

3 Do not pause at all; useful if you often boot with no 
SCSI devices connected. 


TSELCDR.SYS 
/D:driver_name Specifies internal driver name for CD-ROM 


/Pn 


/R 


driver in CONFIG.SYS. This parameter must match the name in 
the MSCDEX command line in AUTOEXEC.BAT. 


Allow Prefetch and/or Seek. 

0 Seek and Prefetch are disabled (default). 
1 Allows Prefetch. 

2 Allows Seek. 

3 Allows both Seek and Prefetch. 


Reset. This sends a RESET command to the SCSI bus before 
the driver loads. 


41 


SC Shots User Guide 


/Un_ Restrict maximum number of Logical Units (LUNs) available. 
Useful when a device, such as a Pioneer CD-ROM changer, has 
multiple logical units that are not all being used. This allows you 


/Wn Pause (warning) mode. 
Pause for a key to be pressed if no SCSI device is detected 
(default). 
2 Pause for a key to be pressed if SCSI device is detected. 
3 Do not pause at all; useful if you often boot with no 
SCSI devices connected. 


iF 9) 
Y 
= 
= 
Fm 
a) 
a 
i? a) 
o 
> 
oe wm 
+ 
C 


TSJILSYS 


/In Instructs the driver to search for the installed scanner at SCSI ID n, 
where n ranges from 0 to 7. Normally the driver polls each device 
on the SCSI bus searching for the scanner. This parameter overrides 
the startup search, unless the driver does not find the scanner at 


this SCSI ID. 


/Wn_ Pause (warning) mode. 
0 Pause for a key to be pressed if no SCSI device is detected 


(default). 
2 Pause for a key to be pressed if SCSI device is detected. 
3 Do not pause at all; useful if you often boot with no 
SCSI devices connected. 
OS/2 .ADD Drivers 


/In_ Sets the interrupt channel; for example, 3, 5, or 7. Be sure 
to set the jumpers on the adapter to match the interrupt channel. 


/O Enables an optical drive to emulate a hard disk drive. Useful in 
situations where IBM’s OPTICAL.SYS file is not available. 


/O0 Restrict maximum number of Logical Units (LUNs) available to 
one. Default is seven LUNs in the August, 1992 driver. 


TFORMAT 


/860 Formats SCSI drives for compatibility with original T128/T228 
Boot ROM release 1.x. If a SCSI drive connected to a T128 or 
T228 does not boot with a version 1.x ROM because it isn’t in 


the ROM tables, this option should fix it. It is not possible to 
boot your system through parallel port SCSI adapters or 
PCMCIA slots. 


/G Performs a low-level format on the media. 


42 


to select, for instance, only the first three LUNs and ignore the others. 


PyypryryarypsriIigs sy 


J 


J 


13) 71 7 3) § 5 FT ] 


ij 


] 


4 


9 OS/2 Software Installation 


This chapter documents the OS/2 drivers supplied by Trantor called 
Adapter Device Drivers (ADD) for Trantor SCSI adapters. These ADD 
files provide an interface between the Trantor SCSI hardware and the 
OS/2 version 2.0 or above operating system. 


Ss 
ae 
6 
Law] 
NH 
“_ 
S 
jonas 
js. © 
ot 
jm « 
oO 
i) 


Support for different SCSI devices is not done by Trantor but by IBM 
with their OS/2 high-level drivers. CD-ROM, hard disk (both fixed and 
removable), SyQuest and Bernoulli drives function with Trantor adapters 
through supported OS/2 drivers. Other Trantor device drivers and utilities 
described in this manual function under DOS only, not under the OS/2 
operating system. 


0S Magic Lantern software requires Windows and Music Box software requires 
MSCDEX to operate. Tape Mate II software is certified to function 
under DOS. 


NOTE 
Support for Trantor’s OS/2 drivers is available from the Adaptec/Trantor 
BBS at 408-945-7727. There is no support available by telephone on this 
product due to the complexity of the CONFIG.SYS. Please leave the 
following items as a message on the BBS: your questions, a copy of the 
errors you see, and a copy of your CONFIG.SYS. 


OS/2 Files 


Your distribution diskette #2 has a \OS2 subdirectory, containing the 
following files. 


OS2_READ.ME—A standard text file explaining how to install and 
configure your hardware for OS/2. Please note that OS/2 technical 
support is provided via fax and technical support Bulletin Board (BBS) 
only—see this file for details. 


OS2.FAQ—OS/2 Frequently Asked Questions text file. Please read this 
before contacting Trantor, IBM, or your dealer for OS/2 technical 
support. 


* ADD—OS/2 Adapter Device Driver files. There are several versions 
supplied for various Trantor host adapters—see the OS2_READ.ME 
file for details of OS/2 support installation and operation. 


*, DDP—OS/2 installation script files. See OS2_READ.ME for details. 


43 


A 
D) 
oom 
a 
= 
‘> 
_ 
at 
A 
oD 
> 
ou 
i 
a 


SC Shots: User Guide 


9.1 Installing OS/2 2.1 Device Drivers 


In order to use a Trantor SCSI adapter with OS/2 software, you must first 
install the OS/2 SCSI support, the DASD support for hard disk drives and 
the CD-ROM support for CD-ROM drives. These drivers are included 
with OS/2 software, but were probably not installed when you first set up 
OS/2 software on your computer. DOS support is usually automatically 
installed in the \OS2\MDOS directory, so you should see the virtual 
device drivers in that directory (VCDROM.SYS, etc). Do not delete these 
files if you want to use DOS as well. 


To install Trantor OS/2 2.1 software drivers follow the procedures below 
before you install OS/2 2.1, as explained in the OS/2 2.1 Installation Guide. 
To install OS/2 2.0 software, see the OS2 READ.ME file on the software 
distribution diskette. 

1 Make a copy of the OS/2 2.1 software Diskette 1. 


2 Copy the TxxxSCSI.ADD file to the copy of Diskette 1 (do not copy it 
into a subdirectory). 

3 Edit the CONFIG.SYS file (located on the copy of Diskette 1) to add 
the following line to the end of the file (do not specify a path for the 
.ADD file): BASEDEV=TxxxSCSI.ADD 

4 Begin the installation by inserting the Installation Diskette into drive A 
and restarting the system. When prompted to insert Diskette 1, insert 
the copy that you modified. 


03> See Chapter 8 for OS/2 ADD Drivers Options. 


9.2 Removable Media (Magneto-Optical, Sy Quest, Bernoulli, etc.) 


IBM treats a removable-media drive as though it were a very large floppy 
which means that you cannot interchange removable media between DOS 
and OS/2 operating systems. 


To format a removable-media drive for OS/2, you first must do a low-level 
format under MS-DOS with the Trantor TFORMAT utility and select a 
single partition—the IBM driver cannot handle multiple partitions on 
removable media. 


Boot up your OS/2 system with this formatted cartridge in the drive. From 
the OS/2 SYSTEM folder, select double click on the Drives icon. Select 
the removable-media drive (which shows up as a floppy icon) and click the 
center button. Select Format Disk and use any available capacity—2.88 
MB works just fine. The removable-media drive is formatted to its correct 
capacity with an OS/2 partition. 


You can now use the drive cartridge under the OS/2 operating system. It is 
not readable by a DOS system. 


44 


J 


jd 7 


| oe oe | 


§otf 


J 


1377 


1 J 


; i ee ee ee 


J 


9 OS/2 Software Installation 
9.3 Setting Up a Hard Drive for OS/2 Software Use 


If you have an existing hard disk drive on your Trantor SCSI adapter set 
up as a single partition under MS-DOS 4.01 or later operating system, you 
should be able to install it under OS/2 software with no special 


requirements other than those discussed here. 


If you have a disk partitioned under DOS 3.3 larger than 32 MB, you 
must re-format it under DOS 4.01 or later for OS/2 software, since 
partition sizes over 32 MB are non-standard. 


So) 
ee 
S 
=} 
7) 
— 
s 
= 
pao 
o. 
‘¢’) 
i? 2) 


WARNING 
Backup your data before you format your hard disk drive or it will be lost. 


To format your hard disk drive, run the DOS-based TFORMAT program 
supplied with the Trantor SCSI adapter, see Chapter 5. There is no OS/2 
version of this program, but it runs from a DOS box or VDM on your 
OS/2 system. 


9.4 OS/2 Software Error Messages 


The System cannot find the file “C:\OS2\SYSTEM\COUNTRY.SYS” 
specified in the COUNTRY command. The System is stopped. 


This error usually happens if the OS2DASD.DMD driver is not 
installed in the CONFIG.SYS. Make sure you have 
BASEDEV=OS2DASD.DMD in the CONFIG.SYS right after the 
BASEDEV=IBM1FLPY.ADD statement. If you installed the SCSI 
support on the OS/2 Installation, you should not get this message. 


This error can also occur if you install OS/2 software on a second 
partition of your C drive and add a second SCSI hard drive for OS/2 
software. OS/2, like MS-DOS software, always mounts primary 
partitions on hard drives before extended partitions. OS/2 software 
assigns the second drive, drive letter D; the second partition on the 
original C drive becomes E. OS/2 software is not able to load files from 
the D drive, since it is now re-assigned as E and since OS/2 operating 
system always tries to load COUNTRY.SYS from D, it errors out at 
this point. Change the drive that the OS/2 files are loading from to fix 
this problem. 


SYS1I718: The System cannot find the file“... ” 


The file indicated has not been installed. This error most commonly 
happens when CD-ROM files are not copied to the System 
subdirectory. Use the OS/2 Selective Install program to install your 
CD-ROM support files. 


45 


A 
cD] 
| 
fond 
= 
ar 
= 
an 
i? a] 
o 
> 
e wm 
dont 
C 


GC Shrors: User Guide 


SYS1201: The device driver “OS2CDROM.DMD” specified in the 
DEVICE command on line... was not installed. Line is ignored. 


The .ADD driver for the SCSI adapter did not load. There is no SCSI 
device attached, the SCSI adapter is not installed, or there is a hardware 
conflict with the SCSI adapter. Make sure you have the IRQ jumper in 
place (if applicable to your adapter) and the correct /Ixx parameter in 
the ADD command line. Check under DOS using SCSITEST to see 
if the SCSI device is identified. 


SYS1201: The device driver “TxxxSCSLADD” specified in the 
BASEDEV=command on line... was not installed. Line is ignored. 


46 


The .ADD driver for the SCSI adapter did not load. If you are using a 
Parallel-to-SCSI adapter, make sure the SCSI device is plugged in and 
powered up correctly. Check your installation under DOS and with 
SCSITEST to see if the SCSI device is identified correctly. With a 
bus-based adapter and an internal drive, check that the ribbon cable is 
not on backwards and that the SCSI adapter is actually installed in the 


computer. 


1td') 939947 


q 


It] 


j 


[ 


] 


10 Windows NT Software Installation 


This chapter documents the Windows NT drivers supplied by Trantor for 
Trantor SCSI adapters and their installation procedures. These files 
provide an interface between the Trantor SCSI hardware and the 
Windows NT operating system. Windows NT operating system provides 
all the necessary device drivers for hard disk, CD-ROM, tape, scanner, etc., 
see your Windows NT documentation. 


BS The Trantor driver interfaces the Trantor SCSI adapter to the Windows 
NT system, it does NOT support SCSI devices directly! Support for SCSI 
devices is supplied by Microsoft as part of the Windows NT operating 
system. 


Ss 
=. 
6 
ar 3 
” 
— 
5 
— 
_ . 
ct. 
ig) 
” 


[3s Magic Lantern software requires Windows to operate, Music Box software 


requires MSCDEX, and Tape Mate II software is certified to function 
under DOS. 


NOTE 
Support for Trantor’s Windows NT drivers is provided via the Adaptec/ 
Trantor BBS at 408-945-7727 and the Windows NT Forum on 
CompuServe. Due to the complexity of the Windows NT operating 
system, support is available only by electronic means. Please leave the 
following items as a message on the Trantor BBS: your questions, a copy 
of the errors you see, and a copy of your CONFIG.SYS. If you have any 
bug reports, please post them on the Trantor BBS. 


Windows NT Files 


Your distribution diskette #2 has a \WINNT subdirectory, containing the 
following files. 


T128.SYS—The driver for the Trantor T128 and T228 SCSI adapters. 
T13B.SYS—The driver for the Trantor T130 SCSI adapter. 
T160.SYS—The driver for the Trantor T160 and T260 SCSI adapter. 
T338.SYS—The driver for the Trantor T338 MiniSCSI adapter. 
T348.SYS—The driver for the Trantor T348 MiniSCSI Plus adapter. 
T358.SYS—The driver for the Trantor T358 MiniSCSI EPP adapter. 
NT_READ.ME—The Trantor Windows NT read me file. Please read for 


the latest information on Trantor drivers. 


47 


i? 2) 
Y 
po 
= 
a 
ae 
al 
BA 
o 
> 
ou 
Yam 
a 


SC Shots User Guide 


OEMSETUP.INF, TRANTOR, TXTSETUP.OEM—These files 
identify the diskette as an OEM diskette to the Windows NT Install 


program. 


Currently, these are the only Trantor SCSI host adapters that are 
supported under Windows NT. There are no plans to support the older 
T100 adapter. 


10.1 Trantor NT SCSI Miniport Installation _ 


To install Trantor Windows NT drivers, follow these instructions: 

1 Copy all the files in the (WINNT subdirectory on SCSIworks! 
diskette #2 toa floppy disk. To install T160, T338, T348, and T358 
drivers, use this new OEM setup disk. 


BSS The T128 and T130B drivers are on Windows NT CD. Windows NT 
operating system always installs these drivers from the CD even though 
you try to install them from the floppy disk. The T128 and T130B 
drivers located on the SCSIworks! diskette can be copied onto the 
hard disk after the installation is complete. The path to copy these 
drivers to is probably C:\WINNT\SYSTEM32\DRIVERS, but may 
vary depending on the installation path. 


2 Select the Custom Install icon from the Windows NT Setup Program, 
and insert the setup disk when prompted. 


48 


’'7 17 43 


J 


4 


17973931929 


If J 


11 NLM Software Installation 


This chapter details Trantor’s ASPI Manager Modules for the Novell 
NetWare 386 v3.11 or later platforms. These modules are called NetWare 
Loadable Modules or NLMs. 

11.1 NLM Introduction 


An ASPI manager is included in the NetWare 386 drivers. Figure 18 shows 
a sample ASPI diagram: 


|S) 
ae 
6 
m= 
7 2) 
a oat 
s 
=u 
jaunt @ 
a. 
g) 
7 a) 


ASPI 


Figure 18 ASPI NLM Diagram 


Given the flexibility of ASPI, many companies are currently providing 
server-based CD-ROM and tape backup solutions through ASPI. There 
are other ASPI modules already developed or under development. 


A programming specification is available from Trantor if you are interested 
in writing your own NetWare 386 ASPI application module. 


11.1.1 Checklist 


The following is a check list of what you need to get started: 


C) IBM PC AT-compatible system or EISA system 

Q) Trantor’s PC/XT/AT-compatible boards (T130, T160, T358) 
CQ) SCSIworks! diskette #2 

C) Novell NetWare 386 v3.11 or later 

LL) One or more Local Area Network (LAN) cards 

QL) SCSIworks! Users Guide (this document) 


Other manuals that may help you: 


QC) Trantor PC/XT/AT-compatible Hardware Installation Guide 
C) 386 Installation, SFT NetWare Manuals (provided by Novell) 


49 


J 


SCShrors: User Guide 


11.1.2 NLM Files 


NetWare Loadable Module files are located in the NLM directory on the 
SCSiworks! diskette #2. These files include: 


= 
—, 

ASPITRAN.DSK—The device driver that provides one entry point for 
any ASPI application. _ 
‘ones 


W 
0) 
‘oo 
ou 
be | 
‘S 
—_ 
a 
i? 0) 
o 
> 
Ce | 
tom 
a) 


MA13B.NLM—The NLM for the T130 SCSI host adapter. 
MA160.NLM—The NLM for the T160 SCSI host adapter. 
MA358.NLM—The NLM for the T358 SCSI host adapter. aaa 


11.2 NLM Installation 


The following is a quick overview for installing Trantor NLMs: 

1 Make one (1) backup copy of each Novell and Trantor supplied 
diskettes using the DOS DISKCOPY command and use these backup 
copies as your working diskettes. 

2 Use the NetWare 386 file SERVER.EXE to start the installation 
process. When you are prompted for a file server name and an IPX 
internal network number, consult the NetWare User Manual for the 
information. 

3 Boot your NetWare 386 file server. Consult the NetWare User Manual 
for the information. 

4 Load the NLM into NetWare 386 using of the LOAD console 
command. See Loading the NLM on page 51 for details. 

5 Make sure the module ASPITRAN.DSK is in the same [path] or in the 
SYSTEM directory of SYS: Volume. 


Parameters 


The following is a list of the parameters available for the Trantor T130, 
T160 and T358 host adapters. The table identifies the syntax and 


parameter options. 


03> Command line parameters must be separated by spaces; however, they can 
be in upper or lower case. 


PORT—The I/O port address for the host adapter. This parameter is 
mandatory, and if a port is not specified at the command line, the 
software prompts you for a port. The syntax is PORT=xarx. 


t 


INT—The interrupt setting. This parameter is mandatory, and if an 
interrupt is not specified at the command line, the software prompts 
you for an interrupt. The syntax is INT=y. 


RESET—Performs a SCSI bus reset upon module load. This parameter is 
optional. The syntax is RESET. 


50 


: ae 


_ 11 NLM Software Installation 
MODE—The mode configuration switch for the T358 host adapter only. so) 
es The syntax is MODE=m_n and the default is 00. Some parallel ports = 
require additional delays to the read and write cycles of the device. You S 
— The amount of 25 
additional time the T358 read and write cycles are delayed is controlled C 
ome by the value of n. = 
nm may be set to any value between 0 to 7 as shown below: 
— 0 (default) inserts no cycle delays (runs at highest throughput rate). Mii 
Fem e 
a 7 adds 875 ns of delay to the MiniSCSI EPP adapter read and write 
a ae 
ae Allowable values for m 
| 0 Auto-port detect (default). 
ae 2 Force unidirectional. 
= 4 Force non-EPP; auto detect unidirectional or bidirectional. 
6 Force non-EPP and force unidirectional. 
~—) 8 Force EPP. 
(a) fe 
[Parameters |Syntax |T130 | T160 7358 | 
a PORT —| Port=sanx/350, 340, |360, 350, 340, 330, |3BC,378, 278 
: 250, 240 /260, 250, 240, 230 
RESET [set [ro opins|roopins —_|wowions | 
am MODE- = | MODE=m n m=0, 2, 4, 6, 8 
17358 only n=0, 1, 2, 3, 4, 5, 6, 7| 
Fes] ee TT EEE 
me Loading the NLM 
The module must be loaded for each host adapter in the system. For 
a) example, if you have three host adapters, you need to load the module 
| three times. If installing more than one host adapter, each host adapter 


ame should have its own SCSI bus. For example, no two T130s should be 
; connected to the same SCSI cable. 


r= = 85 Note that only one image of the module (MA13B.NLM, MA160.NLM, 

or MA358.NLM) remains in memory. Consult the NetWare Installation 
_— Manual for information on installing other NLMs. If an error message 
appears when attempting to load the driver, consult the end of this section 
for a description of the error messages. 


51 


7 9) 
Y 
‘= 
= 
= 
2 
— 
iF 9) 
5) 
> 
© wm 
tam 
a) 


SCShrorc: User Guide 


When you load the driver, you need to tell it which host adapter you are 
loading the driver for, ie. LOAD MA13B. If you do not specify 
parameters, you are prompted for those that are mandatory. To avoid 


NetWare software prompting, type the parameters after the NLM name. 


NetWare software determines if loading the driver causes any conflicts (i.e., 
port or interrupt channel already in use). If there is a possibility of a 
conflict, the driver does not load. 


At the NetWare 386 software prompt (:), use the LOAD command to 
install the driver. The correct syntax to load the driver for the T130B is: 


LOAD [PATH]MA13B [PARAMETERS] 
For the T160: 

LOAD [PATH]MA160 [PARAMETERS] 
For the T358: 

LOAD [PATH]MA358 [PARAMETERS] 


For a T130, assuming the SCSIworks! diskette #2 is in drive A and you 
have a tape backup and CD-ROM drive connected to the T130, the screen 
looks similar to Figure 19 (the software prompts you for mandatory 
parameters when not selected): 


sload a:\nlm\mal3b [Enter] 
Loading module MA13B.NLM 


Trantor ASPI Manager for NetWare, version 1.01 

Copyright (C) 1993, Trantor Systems Limited. All rights reserved. 
--- For The T130B SCSI Host Adapter --- 

Supported I/O port values are 350, 340, 250, 240 

I/O port: 350 [Enter] 

Supported interrupt number values are 3, 5, 7 


Interrupt number: 3 [Enter] 


SCSI Host Adapter detected at address 350h. 


Device 0, Sequential Access Device (Removable Media) 
Device 1, Read-Only Optical Device (Removable media) 


Figure 19 Loading MA13B Without Parameters Specified 


52 


ee ee ee oe 


J) 3 


$i) 1 43 


] 


j 


J 


11 NLM Software Installation 


035° Note that the port and IRQ values which would cause a conflict with 
another device do NOT display. 


Figure 20 shows an example of the driver being loaded with command line 
options used. 


sload a:\nlm\mal3b port=350 int=3 reset [Enter] 
Loading module MA13B.NLM 


0 
—e 
6 
= 
7) 
oe 
= 
— 
ee Me) 
. 
¢) 
a) 


Trantor ASPI Manager for NetWare, version 1.01 
Copyright (C) 1993, Trantor Systems Limited. All rights reserved. 


--- For The T130B SCSI Host Adapter --- 


SCSI Host Adapter detected at address 350h. 


Device 0, Sequential Access Device (Removable Media) 
Device 1, Read-Only Optical Device (Removable media) 


Figure 20 Loading MA13B With Parameters Specified 


Loading the NLM When Server Boots 

To automatically load the NLM when the server boots, you need to add a 
line to the STARTUP.NCF file. This file is created or modified from the 
NetWare INSTALL.NLM program. Load INSTALL.NLM and select 
System Options. Next, select from the Available System Options. 


Then, select from the STARTUP.NCE. Add a line in the 
STARTUP.NCE similar to the one below: 


LOAD MA13B PORT 350 INT=3 RESET 


035° In order for startup to properly execute, the module ASPITRAN.DSK 


must be in the same [path] as the module or in the SYSTEM subdirectory 
of the SYS: Volume. 


Unloading the NLM 
To unload the NLM, at the prompt enter UNLOAD MA13B or other 
module. 


11.3 __Warning and Error Messages 


This section details any warning and error messages that appear on screen. 


Warning Messages 


The following is a list of warning messages and the recommended solutions. 


93 


i? 9] 
0) 
ou 
- 
pice’ 
‘> 
= 
ae 
iF) 
o 
> 
ou” 
den 
a 


SC Shots: User Guide 


Warning: No devices respond on this SCSI host adapter 


The device is not connected to the SCSI host adapter, it is not turned 
on, or not terminated correctly. 

Warning: Invalid option ’X’ included in command line 
The first letter of the option is displayed here. You entered an invalid 


parameter which has been ignored. You may have to unload and 
re-load the module, entering the correct parameter. 


Error Messages 


The following is a list of error messages and the recommended solutions. 
Note that when an error occurs, the software displays the error and then 
displays these two lines: 


Module initialization failed. 
Module XXXXX.NLM NOT loaded. 


ERROR: Host adapter not found at XXX. 


The software cannot find the host adapter at the port address. Be sure 
you have specified the correct port selection. 


Device X: Unable to read device status. 


The device is failing for some unknown reason. Check the device for 
proper termination. 


ERROR: Unable to allocate INTERRUPT resource. or 
ERROR: Unable to allocate IOREGISTRATION resource. or 
ERROR: Unable to allocate AES resource. 


Server would not allow the NLM to allocate resources for operation; 
possibly too many NLMs were being loaded at the same time. Consult 
the NetWare User Manual. 


ERROR: NLM Hardware Registration failed. 


Novell would not allow NLM to register hardware selections with 
server. Consult the NetWare User Manual. 


ERROR: SetHardwarelnterrupt( failure. Retcode = x. 


Novell would not allow NLM to register interrupt with server. Consult 
the NetWare User Manual. 


ERROR: Unable to register with ASPITRAN module. 
Error in the ASPITRAN module. Either the module did not load or it 


was not in the correct path for automatic load. 


54 


yrydy)393. 7199997) YF 


J) ) 9 ) FY 9 7 


=~ 12 Troubleshooting Notes ao 
st 
O 
a a 
7 12.1 All Host Adapters = 
rae During bootup, the driver recognizes the adapter and the SCSI = 
device(s), then stops with a “No SCSI Functions in Use” message. -s 
a © The software driver is looking for a different device. ~ 
| For example, you may have the CD-ROM driver loaded, but you 
son are trying to work with a hard disk drive, or vice versa. Each 
Trantor software driver recognizes the existence of all SCSI devices 
attached to the SCSI chain, but only works with the device it is 


written to communicate with. Install the correct driver, or remove 


an unwanted driver from your CONFIG.SYS file with a text editor 
st program. 


_ Notes 
¢ MS-DOS (or PC-DOS) 3.1 or higher is required (3.3 or higher to 
sae format and use partitions larger than 32 MB). Older laptops with 
DOS 2.x in ROM have to be booted and operated with DOS 3 on 
floppy disk, unless the ROM version of DOS is upgraded. 
ah ¢ Ifan initialization error occurs with scanner devices, the driver 
aborts installation and remove itself. Initialization fails if TSJII.SYS 
ne, cannot access an installed ASPI manager or cannot locate the 
appropriate scanner on the SCSI bus. Otherwise, TSJII.SYS prints a 
ane status message including the scanner model number and SCSI ID. 
12.1.1 _Parallel-to-SCSI Adapters 
= “No SCSI Host Adapter Detected” message appears during bootup 
— ° Improper or missing SCSI device termination. 
Your adapter requires SCSI termination power in order to operate. 
Check to be sure that there is proper termination power available 
aa from your SCSI device. You can do this with a voltmeter by 
| measuring the voltage available between pin 38 and ground on the 
fom SCSI device’s connector (see Section 5.0 for pinout details). Check 
this voltage with power to the SCSI device(s) on; it should measure 
_— approximately +5 volts. Very low or no voltage at pin 25 indicates a 
| problem with termination power; this condition disables the 
parallel-to-SCSI adapter. 


Try this quick test, plug a printer into the printer pass-through 
port. If you have correct TERMPOWER, the printer is able to 


print. 


+5 


i?) 
Y 
= 
o wm 
= 
a 
a 
i?) 
© 
> 
o wm 
Sumi 
A 


GCShrots: User Guide 


Notes 


12.2 Technical Support 


For the T338, check for the proper cable. 
The T338 MiniSCSI adapter requires a standard, Macintosh®- 
compatible 25-to-50 pin SCSI cable—available worldwide. It does 
not work with the 25-to-50 pin cable commonly supplied with 
some Future Domain brand SCSI host adapters. 


Even though you may create a bootable partition with your T338, 
T348, or T358 adapter using TFORMAT, you cannot boot your 
computer with this partition through your adapter. Your computer 
does not expect to boot from a device connected to the parallel port. 
Therefore, your adapter device drivers must be loaded during the 
boot process from another disk. However, you can use a bootable 
partition created by your adapter when the SCSI drive is connected 
to any of Trantor’s other SCSI host adapters which plug into a 
conventional expansion slot. If you do not plan to use the drive with 
any other host adapter, a bootable partition is not necessary. 

If your computer is part of a network installation, your printer port 
may be “redirected” to a network printer. For instance, Novell 
NetWare software uses the CAPTURE command for this purpose. 
If this is the case, the software will not detect the hardware at 
bootup. The simplest solution is to change your computer’s parallel 
port hardware to LPT2 or LPT3, or change your network 
redirection to a different port. 

All MiniSCS! adapters—some older-model 8086-based Sharp® 
laptops have a problem with their parallel port and will not work 
properly with the T348 MiniSCSI Plus adapter, or with other 
programs that use high s speed parallel port data transfer such as 
LapLink® or DeskLink® from Traveling Software. Sharp offers a free 
hardware upgrade for customers experiencing this problem; contact 
your Sharp dealer for details. 

For the T358—if your T358 MiniSCSI EPP adapter does not 
function, set the value of n to 7 for the /M parameter (see the 
Chapter 8). lf your adapter then functions properly, you can 
continue to test it with other n values such as 6, 5, 4, 3, 2, and 1 
until it does not work. Select the last value that does work. The idea 
is to use the lowest value for optimum performance that works with 


your EPP. 


If you are unable to diagnose and fix your problem after reading this 
troubleshooting information, contact technical support at 800-959-SCSI 
(7274) or 408-945-2550, M-Th: 6:00 a.m. to 5:00 p.m., F: 6:00 a.m. to 


56 


Se ee ee ee ee ee 


31 4 


Ypspdy3sy313907d 7 


as 12 Troubleshooting Notes 


3:00 p.m., Pacific time. Or call the BBS 23 hours a day at 408-945-7727; go 
ss 1200/2400/9600 baud, 8 data bits, 1 stop bit, and no parity. Before you =} 
call, be sure you have this information: a 
en ¢ The model number of the Trantor host adapter(s) installed in your fo 
system. = 

rane ¢ The name and version number of the SCSIworks! software — 

product(s) you are using. Ee. 
ia © The type and version number of the operating system you are using is 

(e.g., DOS 5.0). 
aia ¢ The contents of your CONFIG.SYS and AUTOEXEC.BAT files. 
¢ Any error messages that appeared on your screen. 
om ¢ The place from which you purchased your Trantor product(s). 
aa 
al 
(ae, 
ar 
rn) 
fran 
fea 
pmo, 
57 


Shots: User Guide 


fF tt £e 


SOIT) \SIOALIC] 


f ££ tt 


i 


fr ££ bet € t 


58 


i 


Photo CD Viewer 


: 
JS 
a 


fF £kEE€« £ EE oc ££ FEF bE Et Et £t bt tt 


: 
0 
“ 


WIQUE] IgE] 


13. Magic Lantern Operation 


This chapter describes installation and operation of Magic Lantern Photo 
CD viewer for Microsoft Windows operation. If your CD-ROM drive can 
read single and/or multisession photo CDs, Magic Lantern software is the 
software that brings those images to your screen. Magic Lantern software 
supports any Photo CD-ROM drive which implements Microsoft’s 
MSCDEX extensions to MS-DOS (version 2.1 and above). 


I3.1__Magic Lantern Overview 


This section details Magic Lantern files, requirements, and memory 
configuration options. Please read and understand this section carefully 


before proceeding with the Magic Lantern software installation. 


13.1.1 Magic Lantern Files 
Your distribution diskette #2 has a \LANTERN subdirectory, containing 
the following files: 


LANTERN.HLP—tThe help information file for using Magic Lantern 
software. 


LANTERN.EXE—The Magic Lantern software program which operates 


from a Windows environment. 


LANTERN.INI—The initialization parameters which executes Magic 


Lantern software to work in Windows. 


*,DLL—Dynamic link libraries to link Magic Lantern and Windows 


softwares. 


REGISTER.WRI—A Microsoft Write text file which is a registration 
form. Use this form to register your copy of Magic Lantern software. It 
is important that you fill this form out completely and send it to Incat 


System srl. 


INSTALL.EXE—The Magic Lantern installation program execution file 
for installing into Windows version 3.0 or later. 


INSTALL.INF—The Magic Lantern installation information file used by 
the INSTALL.EXE file during installation. 


13.2__Magic Lantern Installation 


To install Magic Lantern software, from the Windows File menu, select 
Run under the File menu. Then enter az: \lantern\install. 


61 


P 
: 
: 


Shots User Guide 


Answer the questions as prompted. The default directory name in which all 
Magic Lantern files are stored is C:\LANTERN. 


Deinstallation 
If for any reason you need to deinstall Magic Lantern software, all you 
need to do is delete the directory where you installed it (the default is 


C:\LANTERN) and all its files. No files have been written anywhere else, 
nor have modifications been made to WIN.INI. 


First check the Magic Lantern directory you are deleting to ensure that you 
are not going to lose information you want to keep! 


13.3 eration 


1 From the PhotoCD menu, select Memory, or click on the Memory 
button in the Toolbar (if the Toolbar is not visible, select Toolbar from 
the Windows menu). The Memory dialog box has the following 
options: 

Anplicsdon—he number at the right of the slider bar in the dialog 
box which indicates the total amount of available RAM and virtual 
memory. Move the slider until the number in the MB box indicates 
the amount of memory you wish to dedicate exclusively to Magic 
Lantern software; the remaining memory is used for Windows and 
any other programs you wish to run at the same time. 


Poster—the number at the right of the slider bar in the dialog box 
which indicates the maximum size of the image you can load—to 
the limit of 16 MB imposed by Windows. Move the slider within 
the bar until the number in the MB box indicates the size of the 
Poster image you desire. Remember that the amount of time it takes 
to load the image is proportional to the size (in memory terms) of 


the image. 


Banding—if Banding is checked, the images are loaded in chunks 
rather than in a continuous stream. This technique is best for slower 
386 PCs with up to 8 MB memory, or with computers that do not 
have an optimized configuration. If, however, you have more than 8 
MB of memory, we recommended that you do not select Banding 
so that your pictures load faster. 
2 Click on OK to accept the values and close the dialog box. 


3 Select Drive from the PhotoCD menu. In the dialog box select the 
drive letter corresponding to your CD-ROM drive and click on OK. 
Magic Lantern software can also read a Photo CD image from hard 


disk, provided the entire file structure of the Photo CD has been copied 
onto the hard disk. 


62 


ee es es es ee a 


y 


cs ee ie ee es ee 


4 


q 


13. Magic Lantern Operation 


If this is not the first time you're running Magic Lantern software, and 
you have not changed the configuration of your PC, you can proceed 
directly to the next step. 

4 From the PhotoCD menu, select Load PhotoCD. All the images on 
the CD are loaded into the Thumbnails window. 


The number of thumbnails visible depends on the size of the 
Thumbnails window. They automatically rearrange when you resize the 
window. If Exact Size is checked in the Windows menu, the window 
always “snaps to” the nearest size which fits whole rows and columns of 
slides; that is, no slides are shown cut off by the window frame. If it 
doesn’t matter that the slides are cut off, uncheck Exact Size. 


Once a CD is loaded, the menu bar changes and more menus become 
available. One of the “slides” in the Thumbnails window is selected (by 
being outlined in red). You can click on any slide to select it or use the 
Go To command from the Thumbnails menu. 


Magic Lantern Program Group—the window is empty if this is the 
first time you're running Magic Lantern software. 


035° Any loading operation can be cancelled at any moment either by 


pressing the [Esc] key or by clicking on the Cancel button. 


For further instructions, read the on-line help instructions by selecting the 
Help icon and choosing the help information you need. 


13.3.1 Mouse Control 


If you have a mouse installed, a mouse cursor appears permitting point- 
and-click interaction with Magic Lantern software. Operation is very 
simple—clicking anywhere inside the perimeter of a button performs the 
desired function. 


13.3.2 __Keyboard Control 


Whether or not you have a mouse, Magic Lantern software can also be 
controlled from the keyboard. The following table is a quick reference list 
of the Magic Lantern commands, key controls, and hotkey controls. 


[commands __[KeyCorres [Hoteye [Rote era 
DRIVE C—~C~C~*dALTCCHD] | PhotoCD 

UNLOAD —C(itst*~*~“‘*‘*ALTVCCHUUSCSdTSCPhotOCDS 
MEMORY CSALT4+C4M | ~—C*dPhotoCD— Cd 
[CDINFO,—S—SCSC*dALCT Ct =| SS Photo CD 


1 a 4 


63 


= 
ce 
EI 
= 


5 
: 
3 


SC Shots: User Guide 


CLOCKWISE 


—U 


hoto CD 


CTRL+G umb. & Transform. 
CTRL+L | Thumb. & Transform. 


Thumb. & Transform. 


eal Thumb. & Transform. 
le se cd Thumb. & Transform. 
eee 


= 


Thumb. & Transform. 
fF Thumb. & Transform. 
ees 2 gil Thumb. & Transform. 
P| Thumb. & Transform. 
ie a9) Thumb. & Transform. 
A a Thumb. & Transform. 
eee ad Thumb. & Transform. 


CTRL+R 
Windows 


ioe ee 
ALT+W+V | Windows 

ae 

po Windows 
ae Windows 


Windows 
Windows 


LT +W, 1, 2, 3, ... 


ALT+W+eE | 
a 


LT+P+C CTRL+INS 


aa Windows 
ALT+P+X_ | 


CTRL+F 


ae 
Lie) 
a Rotation 
= 


Rotation 


—————— Oe ee 


ALT+R+1 
ALT+R+0 


13.4 Magic Lantern Troubleshootin 
Refer to Chapter 12 for further technical support. 


The Windows version of Magic Lantern software doesn’t recognize my 
CD-ROM drive. 


64 


e First, make sure that you have a Photo CD-compatible CD-ROM 
drive and that it is properly installed and configured. Make sure that 
MSCDEX has been loaded. If the CD-ROM is installed and 


Jo'}tidsid13571 3) 93939 ¢ IF t31357tF 17 Ff 1 


13. Magic Lantern Operation 


operating properly, you should be able to use the DOS DIR 
command with the CD-ROM drive when a data disc is loaded; 
audio discs will give an error; this is normal. 


¢ Make sure you have a photo CD in the CD-ROM drive. 


65 


f ££ ££ éi£ELEeE&tLELELLEELE ELE EL EUCE 


GCShrare: User Guide 


66 


KX Mf ff/ 
CW lg 


Audio Control Software for CD-ROMs 


EF £FeEka&teE ELE Eke ft eE fF tEE EE ELE EEL tei 


68 


mT ASU pf 


14 Music Box Operation 


This chapter describes installation and operation of Trantor’s Music Box 
CD audio disc control software for MS-DOS operation with CD-ROM 
drives (hereafter referred to as “Music Box software”). Music Box software 
gives your CD-ROM drive most of the features of a sophisticated CD 
player! It supports any CD-ROM drive which implements Microsoft’s 
MSCDEX extensions to MS-DOS for CD-ROM (version 2.1 and above), 
supports audio functions and has a software driver that implements audio 
functions. This package includes a standard MS-DOS command-line 
version with graphical interface (which may optionally be run in 
memory-resident mode) and a Microsoft Windows 3.x version which also 
incorporates a disc database feature. 


14.1 Music Box Files 
Your SCSIworks! distribution diskette #1 has a \MUSICBOX 


subdirectory, containing the following files: 


MUSICBOX.EXE—The standard version of Music Box software, with 
graphical interface, designed to run from the MS-DOS command line. 
This version of Music Box software may be optionally run as a 
memory-resident application (referred to as Music Box TSR software). 
Once installed, Music Box TSR software takes up about 18 KB of 
memory, and provides most of the commands available in graphical 
interface mode. When memory resident, Music Box TSR software uses 
keyboard control only, and provides audio feedback to the user through 
the computer’s speaker, thus making it usable in any screen mode, even 
when graphical software (except Windows) is running. 


MBOXRES.EXE—A version of Music Box software which invokes the 
memory-resident option, then immediately returns to the DOS 
command line. See Section 14.5.5. 


MBOXRES.OVL—An overlay file used by the memory-resident version of 
Music Box software. This file must be in either the current directory or 


the DOS path when the memory-resident version of Music Box 
software is loaded into memory. 


MBOXWIN.EXE—The Microsoft Windows version of Music Box 
software, for use with Windows version 3.0 or later. Includes a disc 
database to store disc/track titles and play-order preferences. 


MBOXREAD.ME—A text file which may be included, containing 
up-to-date information since this manual was printed. It is important 
that you look for this file and, if it exists, it car 


69 


a 
XS 


GC Shor: User Guide 


14.2 Requirements 


The following are hardware and software requirements specific to Music 
Box software; see Appendix A for more details. 


14.2.1 Hardware 


Music Box software is designed to operate with virtually any CD-ROM 
drive for IBM-compatible computers. No specific CD-ROM hardware 
configuration is required, but it is presumed that your CD-ROM drive is 
properly installed and functioning prior to installation of Music Box 
software. 


The MS-DOS command-line version of Music Box software automatically 


recognizes and operates with the following video graphics card standards: 
CGA, EGA, VGA and Hercules® Monochrome Graphics 


Other video card designs may work, but are not certified to do so. You 
must have a graphics card installed to use the graphical and Windows 
versions of Music Box software; text-only displays are not compatible. CGA 
displays runs Music Box software in relatively low resolution compared to 
the others. The Windows version of Music Box software functions with any 
graphic display supported by your version of Windows. Music Box 
software, in memory-resident mode, may operate properly with text-only 
video display systems, but is not certified to do so. 


14.2.2 Software 


Since MS-DOS (through version 5.0, as of this writing) does not directly 
support CD-ROM drives, Music Box software requires that Microsoft’s 
CD-ROM software extensions for CD-ROMs (MSCDEX) and an 
audio-capable CD-ROM driver be installed. Both are supplied with your 


software—see Chapter 4 for installation instructions. 


14.3 Music Box Installation 


Prior to installation and first use of Music Box software, you should make 
sure your CD-ROM software driver and hardware are completely installed 
and working properly (see Chapters 3 and 4 for details). 


Installation of Music Box software consists of copying the contents of the 
\MUSICBOX< subdirectory on your software distribution diskette to your 
own hard disk drive. We recommend that you place the Music Box files in 
the same location as your other CD-ROM files, which is typically the 
\TSCSI subdirectory on your hard disk. For convenience, the location of 
the Music Box files should be in a PATH statement in your 


70 


1. 1 3 5 J 


q 


11] J 


J 


' oy ] 1 


J 


111 7 


J] 


J 


14 Music Box Operation 


AUTOEXEC.BAT file, so that Music Box software may be loaded from 
any current directory on your system. See your MS-DOS documentation if 
you are not familiar with the PATH command. 


To copy the files, first move to your desired diskette or subdirectory, then 
use the DOS COPY command to copy the files as follows (assuming the 
software distribution diskette is in Drive B): 


COPY B: \MUSICBOX\*.* 


No additional preparation is necessary, as Music Box software automatically 
recognizes and adapts to your video display and CD-ROM hardware. 


14.4 Running Music Box Software 
This section details running Music Box software both from the MS-DOS 


command line and from Windows. If you plan to use Music Box software 
with Microsoft Windows, skip to Section 14.4.2. 


14.4.1 From the DOS Command Line 


To run Music Box software in the graphical non-resident mode, type 
MUSICBOX from your DOS prompt. The memory-resident option is 
described below, but running Music Box software first in non-resident 
mode helps you to learn its functions. 


When run from the command line, Music Box software displays a brief 
copyright notice, then switches to graphics mode for operation (see 


Figure 21). 


Music Box 


Stop Play § Pause Search 


PL JEL IL 


Time Mode Rudio Eject 


Figure 21 Music Box Command-line Graphical Interface 


71 


Me use Don 


GC Shrods! User Guide 


If you are running Music Box software with a Hercules-compatible 
monochrome graphics adapter, you are asked to confirm the switch 
to graphics mode. 


Now that Music Box software is running, please skip to Section 14.5 for a 
full description of the commands available to you. 


14.4.2. Running Music Box So 


If you wish to use Music Box software in the Microsoft Windows 3 
environment, you should first install Music Box software as a Windows 
Application in the Program Manager. See your Windows manual for 
instructions on how to do this. For convenience, you may wish to load 
Music Box software automatically, when Windows is loaded, by adding it 
to the “RUN =” line in WIN.INI. See your Windows manual for 


information about how to do this. 

To start Music Box software in the Windows environment, simply 

double-click on its icon to bring up its Main Control Panel (Figure 22). 
Music Box 


Untitled 


Elapsed Elapsed Remaining Remaining 
Track CD Track CD 


Normal Continuous Shuffle Memory 


Stereo Mute Right Left 


Figure 22 Windows 3 Main Control Panel 


Once loaded in Windows, Music Box software may then be run like any 


other Windows application, including resizing, moving and minimizing it 


to an icon. If you are unfamiliar with standard Windows application 
functions such as these, see your Windows manual for a complete 
description. When minimized, the Music Box software icon displays and 


72 


Oe ee ee ee es 


i oe ee 


|e 


q 


J 


J 


14 Music Box Operation 


updates the current time display information. As long as you remain in the 
Windows environment, Music Box software continues to monitor and 


control the audio operation of your CD-ROM drive. 


Please continue with Section 14.5 for a full description of the commands 
available to you. 


14.5 Learning Music Box Software 


Once running, the graphical command-line version of Music Box software 
and the Windows version operate similarly (except for the disc database 
feature available in the Windows 3 version only, described below in Section 
14.5.4) with some differences in their appearance. Refer to Figures 21 and 
22. Note that not all CD-ROM drives support all audio functions. 


If you haven’t loaded a disc, Music Box software indicates “no CD” in the 
display window, and indicates track #00. If you have loaded a disc with 
data tracks only (no audio tracks), Music Box software indicates “no CD” 
in the display window, and indicates track #01. In this event, inserting a 
disc with audio tracks and clicking on Play resets Music Box software and 
begin play; it is not necessary to exit the program and restart. 


Music Box software allows you to select any track on your audio disc and 
play it on your audio-capable CD-ROM drive. If you have loaded a 
mixed-media disc which also contains digital data, non-music tracks are 
skipped and Music Box software begins operation at the next available 
audio track on the CD. 


Most functions are self-explanatory, and work in a fashion similar to 
conventional CD audio players, but there are some additional features 
which are explained below. 


Music Box software displays the total CD time when it is first activated. To 
the left of the time display is the Track Number indicator. For an all-audio 
disc, this displays Track 1 when Music Box software is first loaded; a mixed 
media disc displays the number of the first audio track. 


To exit Music Box software at any time, press [Esc] (for the DOS version) 
or [Alt] + [F4] (for the Windows version) or use your mouse to click on 
the small Close Box in Music Box software’s upper left corner. If the 
current CD is playing, it continues to do so until the end of the disc is 
reached. If you exit and then reload Music Box software, the current play 
information displays. 


73 


SS 
XS 


GC Shorts User Guide 


14.5.1 Mouse Control 


If you have a mouse installed, a mouse cursor appears (as shown in Figure 
21) in the graphical command-line and Windows versions, permitting 
point-and-click interaction with Music Box software. Operation is very 
simple—clicking anywhere inside the perimeter of a button performs the 
desired function. 


14.5.2 __Keyboard Control 


Whether or not you have a mouse, Music Box software may also be 
controlled from the keyboard. In the function explanations which follow, 
the equivalent key is listed in parentheses and is usually the same as the first 
letter of the function. 


14.5.3 Music Box Control Functions 


2 Just to the left of the Track Number display are the Track 
Skip buttons. The upper button (or [Up Arrow] or U on 
your keyboard) skips forward to the beginning of the next 
track, the lower button (or [Down Arrow] or D on your keyboard) skips 
backward to the beginning of the current track on the first click, then back 
to the beginning of previous tracks with subsequent clicks. Note that if 
Music Box software is in Shuffle mode (see Made, below) the Track Skip 
buttons skips to a randomly-chosen track, not necessarily the next or 
previous track. 


When you click on the Play button (P on the keyboard), 
the CD begins playing and the elapsed time of the track 
you are playing displays. 


You can change the time display by clicking on the Time 
button (T on the keyboard), which has a clock icon 
displayed on it. Each click cycles the time display through 
Elapsed Track Time, Elapsed CD time, Remaining Track Time, and 
Remaining CD Time. You must be in the Play mode to select these 
alternate time displays with the Time button. 


Clicking on the Stop button (S on the keyboard) causes 
the CD-ROM drive to stop playing and to return to the 


first audio track. 


The Pause button (or [Spacebar]) stops at the current 
play location and resume playing when either the Pause 
or the Play button is clicked. 


The Search buttons moves the play point quickly in 
either direction. (The F or [Right Arrow] to search 
forward, the R or [Left Arrow] key to search in reverse.) If 


74 


14 Music Box Operation 


you continue to hold down the Search button or key, the search speed 
increases and larger jumps between audio segments are made, up to a 
maximum of 30 seconds per jump. When the Search button or key is 
released, the CD continues in Play mode from that point. 


The Mode button (M on the keyboard) allows you to select 
the various operating modes available as follows: 


¢ Normal—the CD plays starting at track 1 and continuing to the 
end of the disc. 

¢ Continue—the CD continuously plays through to the end of the 
disc, then restart from the beginning. 

° Shuffle—Music Box software randomly plays all tracks on the CD 
before beginning the shuffle play again. 

° Memory—Music Box software queries the disc database for the play 
order designated (Windows 3 version only). 


Note that, when running from the DOS command line, Shuffle and 
Continue modes require that Music Box software remain on screen to 
control CD operation. If either Shuffle or Continue mode is selected, and 
Music Box software is closed, the CD continues sequential play from the 
current play location to the end of the disc. In Windows, you many resize 
or minimize Music Box without disturbing play operation. 


The Audio button (A on the keyboard) allows you to select 
either Stereo, Right, or Left channel output, or you may 
Mute the output entirely on CD-ROM drives that support 
these commands. Repeated pressing of this button cycles through the 
various options. 


The Eject button (E on the keyboard) stops playing the 
disc, and eject the disc carrier on CD-ROM drives that 
support the Eject function. 


The Close Box in the upper left corner ([Escape] on the keyboard) 

exits Music Box software and returns you to the MS-DOS 

command line or Windows, depending on which version you are 
running. Note that the standard Windows Close Box is used for the 
Windows version of Music Box software. 


14.5.4 _Using the Windows 3 Version 


There are a few differences between the Windows 3 version of Music Box 


software and the DOS command-line graphical version. 


75 


GCS hrvoris User Guide 


Minimized Icon Display 

If you minimize Music Box software to an icon in Windows 3, the 
currently programmed play settings continues to govern operation of the 
CD-ROM and the icon itself displays and update the time display 


normally shown in the Music Box software window (we don’t want you to 


feel left out!). 


Fine-Tuning the Windows 3 Version 

Music Box software “polls” the CD-ROM disc during play mode to update 
the time and track display information. By default, polling occurs every 
two seconds, and on slower computers or with slow CD-ROM drives 
polling can slow down overall Windows performance. 


If you discover that some programs are operating sluggishly under 
Windows when Music Box software is running, try reducing the polling 
rate by adding the following to your WIN.INI file using any text editor: 


[MUSICBOX] 
POLLRATE=5000 


The POLLRATE is expressed in milliseconds; 5000 causes polling to occur 
every five seconds (instead of the default of two seconds), 10000 would 
poll every ten seconds, etc. 


Music Box 


Elapsed Elepsed 
Track cD 

Normal Continuo 

Stereo Mute 


Play Order 


| | 
Copyright {c) 1991 Trantor Systems, Ltd. 


Figure 23. Windows 3 Database Control Panel 


76 


q 


$37 993 3 397973 79 7 


14 Music Box Operation 
Disc Database Operation 


The Database button brings up an additional Windows 3-only Music 
Box feature. The first time you use run the Windows 3 version, Music Box 
software creates empty database files on your system, and inform you of 
this fact. Then, from the Database Control Panel (Figure 23), you can 


enter CD disc names, track names and play order. 


[35> To play tracks in the sequence you've set in the Database Control Panel, 
remember to select the Memory mode by pressing the Mode button on 
the Main Control Panel. 


Each CD audio disc has a unique ID that is automatically logged into the 
database. Additional information such as the number and length of each 
track is also encoded directly on the disc, but name information is not, so 
you ll have to manually enter this information into the database (one time 
only) if you wish to make use of it. To enter a CD into the database, insert 
the CD into your drive and click on the Current CD button. If the CD is 
not recognized by Music Box software, it is given a default name of 
Untitled (see Figure 23). This name must be changed for it to be saved into 
the database, so type a new name into the Selection box, then click on 
Accept Name. The CD name is now saved in the database and is 
recognized whenever it is inserted and Current CD is clicked. 


To enter track names and play order into the database, make sure the 
correct CD is inserted in the drive, then click on Current CD. The CD is 
recognized and any already existing track information displays. Use the 
scrollbar and the edit table to change/enter any track name and the play 
order desired. 


The Default play order button can be used to reset the play order to 
sequentially play all tracks in standard order. The Clear play order button 
clears all play order fields; you may then enter a new play-order sequence 
for any or all tracks. For example, if you click on Clear then enter 1 for 
the third track and 2 for the first track, the Memory mode plays tracks 3 
and 1 in sequence—no other tracks plays. As an added feature, you can 


Track # 1 2 3 4 5 
Play Order 3 not played 1&2 5&6 4 


specify playing track 3 twice for each play of track 1, by entering 1 2 for 
the third track (make sure a space separates the numbers) and 3 for the first 
track. To skip a track entirely, make sure the Order column has no entries. 


Example: Figure 24 illustrates an example of track resequencing. As shown, 
Music Box software plays the disc tracks in the following order: 


77 


Ss 
. 


SCShrorts User Guide 


Music Box 


Music Box Database 


Dave Brubeck Quartet "Time Out* 

Bob Marley "Babylon by Bus" +} 
Crosby, Stills, Nash & Young “Dejal_} 
Dave Brubeck Quartet "Time Out’ 


Selection: 


Deadicated 
Dvorak Symphony #9 "New World” 


Grateful Dead “Workingman's Dea 
John Mayall "The Turning Point" 


Normal Continuous Mozart ‘Violin Concertos” + 
ae ioe Tk # Order Track Name 

1 [3 [BlueRondosteTuk 

| |StrangeMeadowLark 


re |tekerve SS 
56 [Three to GetReady 
Cs 20 


Play Order 
| | 


Copyright {c} 1991 Trantor Systems, Ltd. 


Figure 24 Database Entries, with Track Resequencing 


a & WwW 


The Revert button reads the last-saved play order back into the database, 
in case you change your mind about the current changes. When you are 
finished editing the track name and play order list, click on the Save CD 
button to save the track list and play sequence permanently. 


Over time, you'll probably enter a number of disc titles into the database. 
These appears in the name-list box, with a scrollbar if necessary to 
accommodate a large number of discs (Figure 24). CDs other than the 
current one in the drive may be edited by clicking on the desired CD in 
the name-list box. The Delete CD button deletes the selected CD from 
the disc database. If the CD being deleted is the selected CD then the 
reserved name Untitled is created for that CD. The name of a CD may 
changed by selecting the desired CD, typing a new name, and clicking on 
the Accept Name button. 


When you're finished editing the database, close the database control panel 


by clicking on OK or using the Close Box provided in the upper left corner. 


14.5.5 Running Music Box Software in Memory-Resident Mode 


You may choose to load the DOS version of Music Box as a Terminate and 
Stay Resident application (referred to as “Music Box TSRapplication”). 
When memory-resident, Music Box TSR application occupies about 18 KB 
of memory, and once loaded, may be invoked at any time, even while 
running other applications (except Windows). 


78 


JY399 7939979 3979779797) Y 


yy ] 


$379) ) 479 


14 Music Box Operation 


ym = IS Music Box TSR application should not be used if you run Microsoft 
Windows, as Windows inhibits the keystrokes necessary to operate Music 
Box TSR application. Use MBOXWIN instead. 


There are two ways to load Music Box TSR application: either directly into 
ram, memory from the MS-DOS command line, or while simultaneously 
invoking the standard graphical interface. 


rman ¢ Ifyou choose to load Music Box TSR application at the same time 
you invoke the graphical interface, simply type MUSICBOX with 
one of the command-line switch options shown below. 

e If, however, you wish to load Music Box TSR application directly 
into memory, type MBOXRES, optionally adding one of the 
command-line switches shown below. Loading Music Box TSR 
application in this manner returns you directly to the DOS 

anal command line, and is particularly useful for loading Music Box TSR 

application from a batch file, such as AUTOEXEC.BAT. 


[3° Note that MBOXRES.OVL, included on your SCSIworks! diskette, must 
ve be available either in the current directory, or via the PATH command of 
_ MS-DOS, for Music Box TSR application to load properly. rN 
_— The command line switch options for Music Box TSR application are as & 
follows (note that either upper or lowercase characters are acceptable): bs 
— /R makes Music Box application memory-resident. The “hotkey” is 8 
the key combination which, when pressed, suspends your current 
_— application and invokes Music Box TSR application. [Ctrl]-[Left 
Shift]-[Tab] is the default hotkey. Note that all three keys must be 
pressed simultaneously. This switch is the default when 
= MBOXRES is executed. 
_— /Rx changes the resident version’s hotkey combination from the 


default of [Ctrl]-[Left Shift]-[Tab], where x is the keyboard 
character desired (allowed characters are A-Z and 0-9). The 


chosen character is always used in conjunction with [Ctrl]-[Left 


Shift]. 
ac Examples: 
The following invokes Music Box software in memory-resident mode, with 
— the default [Ctrl]-[Left Shift]-[Tab] hotkey, and then presents the 
~~ graphical interface. When you exit the graphical mode, Music Box TSR 
rome application remains in memory. 
_ MUSICBOX /R 
Or set the hotkey to [Ctrl]-[Left Shift]-m 
79 


GC Shrorc: User Guide 


MUSICBOX /RM 


The following invokes Music Box software in memory-resident mode, with 
the default [Ctrl]-[Left Shift]-[Tab] hotkey, then immediately returns you 
to the MS-DOS command line prompt. (This is equivalent to typing 
MBOXRES by itself, as the /R switch is assumed.) 


MBOXRES /R 
Or set the hotkey to [Ctrl]-[Left Shift]-5, 
MBOXRES /R5 


Note that if you wish to change the hotkey combination after Music Box 
TSR application has been loaded, you must first completely unload Music 
Box TSR application (with the [Ctrl]-X command), then reload it with 
your new hotkey selection. If you attempt to load Music Box TSR 
application with a different hotkey when Music Box TSR application is 
already loaded, the new loading attempt is ignored. 


14.5.6 Music Box TSR Software Commands and Audio Interface 


In memory-resident mode, Music Box TSR application uses audio 
feedback, rather than a screen display, to convey information (that’s why 
you don’t get any pretty screen illustrations in this section). This method 
allows Music Box TSR application to operate in conjunction with virtually 
any non- Windows application you may be running, including programs 
that run in graphics mode, and greatly reduces the amount of memory 
needed to remain resident. 


When the hotkey combination is pressed, Music Box TSR application 
responds with a series of descending tones to inform you that it is in 
operation. Until you exit back to your application (with the [Escape] key), 
Music Box TSR software either executes CD-ROM audio commands or 
responds with a low error tone if an inappropriate key is struck. When a 
keystroke command is entered, Music Box TSR application acknowledges it 
with a tone. 


When running, Music Box TSR software uses the same keyboard 
commands as those which are allowed in the non-resident graphical mode: 


P begin or resume play. 
Ss stop playing and return to track 1. 
[Spacebar] pause or restart play. 


U or [Up Arrow] skip to next track. 

D or [Dn Arrow] skip to beginning of the current or previous track. 
F or [Rt Arrow] _ search in the forward direction. 

R or [Lt Arrow] _ search in the reverse direction. 


80 


3) ] 


'3 9 3)9)9 3 


J 


Jo9)o39 7 


}4 


j 


14 Music Box Operation 


E stop play and eject the CD disc. 
M cycle through the various Mode options. 
A cycle through the various Audio options. 


[3 Note that the Time command is not functional in TSR mode, as there is 


no information display. 
There are also two special keystrokes for use with Music Box TSR software: 


[Esc] exits back to your application. 
[Ctrl]-x unloads Music Box TSR software from memory 


(see below). 


14.5.7 Unloading Music Box TSR Software 


To unload the memory-resident version of Music Box software from 
memory, press [Ctrl]-X (i.e. hold down [Ctrl] while pressing X) while you 
are at the MS-DOS command line level and Music Box TSR software is 
running. Note that Music Box TSR software must be the last 
memory-resident application loaded into memory in order to unload it, to 
avoid disturbing the operation of other memory-resident programs. 
Otherwise, Music Box TSR software is disabled, but still occupies memory 
space. An attempt to unload Music Box TSR software from within another 
application is ignored. 


14.5.8 Reloading Music Box TSR Software 


If Music Box TSR software has been removed from memory or disabled via 
the [Ctrl]-X keystroke, you may reload it at any time. If disabled, reloading 
re-enables Music Box TSR software, otherwise the reloading places Music 
Box TSR software back in memory. Reloading never causes more than one 
copy of Music Box TSR software to be in memory at any time. Refer to 
Section 14.5.4and 14.4.2 for information on .INI files. 


14.6 Music Box Troubleshooting 
Refer to Chapter 12 for further technical support 


The Windows Version of Music Box Software Doesn’t Recognize My 
CD-ROM. 


e First, make sure that your CD-ROM drive is properly installed and 
configured and that MSCDEX has been loaded. If the CD-ROM is 
installed and operating properly, you should be able to use the 
MS-DOS DIR command with the CD-ROM drive when a data 
disc loads. 

e Ifyou believe your CD-ROM drive is installed properly, try running 
the command-line version of Music Box software by typing 
MUSICBOX. If this version operates properly, your CD-ROM drive 
installation is operating correctly. 


81 


CShrors: User Guide 


¢ Make sure you are not attempting to use the standard DOS version 
of Music Box software (MUSICBOX.EXE) from within the 
Windows environment. To operate properly with Windows, you 


must use the Windows-only version (MBOXWIN.EXE). 
When Music Box Software is Running, Windows Operation Seems 
Sluggish. 


This is probably due to the polling rate of the Music Box software 
time and track information display. See Section 14.5.4 for details of 
how to change the polling rate. 


as 
S 


82 


yoy?) 7) 3 39°93 7 9 


§$)39090 7 4] 


J 


}o' yd 4 


Tag 
eee || 


Tape Backup Software 


=— 
D 
‘ 
= 
© 
at 
a 


fF £ ££ € t £€t ft f£ b € € £€ € ££ £££ ft Ef 


84 


J] QaoW edb] 


15 Introduction to Tape Mate II Software 


Tape Mate II software is a powerful archiving and data management 
system designed for single-user computer systems. With Tape Mate II 
software, you have the flexibility of backing up or restoring all or part of 
one or more disk drives, and you can perform the operation immediately 
or schedule it to run automatically later. 


15.1 Hardware Support 


Tape Mate IT software supports a wide range of hardware devices and 
media, including fixed and removable disk, tape, digital-audio tape (DAT), 
and magneto-optical drives. Any device (fixed and removable hard disk, 
and optical drive) that has a DOS drive designation is supported through a 
DOS driver. Tape Mate II software supports tape drives through SCSI 
adapters. Nearly every SCSI Y4-inch cassette and DAT drive made is 
supported. Please review the SUPPORT.LST file on your distribution 
diskette for currently supported devices. 


15.2 Tape Mate II Features 
You can use Tape Mate II software to 
¢ back up data. 


e restore data. 
e verify the integrity of data that has been backed up or restored. 


In addition, Tape Mate II software offers utilities that allow you to 


¢ create and manage a database of the backup, restore, and verify 
operations. 

schedule backup, restore, or verify operations that run automatically. 
erase or format tapes and floppy disks. 

read and print log files of the backup, restore, and verify operations. 
eject tape cartridges. 

¢ retension a tape (retensioning helps maintain the integrity of tapes). 


All features are designed to give you maximum flexibility in deciding what, 
when, and how to back up your data. 


15.3 __Using the Tape Mate II Section of this Manual 


Begin with the installation procedures in Chapter 16. If you have never 
used a backup program before, your next step should be reviewing Section 
17.2, which explains basic concepts in backing up data. Experienced users 
can skip to chapters of interest: 


¢ Chapter 16—describes the procedure for installing and configuring 
the software. 


85 


SC Shorts User Guide 


86 


Chapter 17—provides such basic information as using menus and 
dialog boxes and typical backup procedures. 

Chapter 18—explains the procedure for backing up data. 
Chapter 19—describes the procedure for restoring data. 

Chapter 20—describes the procedure for verifying data. 

Chapter 21—explains how to select and schedule an operation to 
run automatically at a specified time. 

Chapter 22—explains how to create a script file that performs the 
backup, restore, and verify operations automatically. 

Chapter 23—describes the database and the options for viewing 
and managing its contents. 

Chapter 24—describes the utilities. 

Chapter 25—explains how to set local and global configuration 
parameters. 


Io 3) 7) 9 7 9 7 I 


J § 37 J 


4 


16 Installation and Configuration 


This chapter describes how to install and configure Tape Mate II 


software. Be sure to consider the items listed in Section 16.1 prior to 


installing the software. 


16.1 Before You Begin 


Before installing Tape Mate II software: 

1 Read the contents of the TMTREAD.ME file on the Tape Mate II 
distribution diskette #2. If included, this file contains information 
about recent changes that may not be included in this manual. To read 
it, insert the Tape Mate II distribution diskette in the disk drive (drive 
A, for example); then type TYPE A: TMTREAD.ME | MORE and 
press [Enter]. If the text fills more than one screen, press [Enter] to 
display another screen of text. 

2 Install the ASPI manager (MAxxx.SYS) onto your boot drive using the 
main SCSIworks! install program. See Chapter 4 for details. 

3 Verify that your archive device is supported before installing the device 
or Tape Mate II software. Supported devices are listed in 
SUPPORT.LST and TMTREAD.ME files on your distribution 
diskette #2. 

4 Verify that system requirements are met (see Appendix A). 


5 Install the archiving hardware. 


16.2 Installing Tape Mate II Software 


Follow these instructions to install Tape Mate II software: 

1 Insert the Program Diskette in drive A (or B, as appropriate). At the 

DOS command line, type As and press [Enter] (if you inserted the 

diskette in drive B, type B: and press [Enter]. 

Type INSTALL and press [Enter]. 

3 At the Enter Target Drive ID prompt, type the letter of the drive on 
which Tape Mate II software is to be installed; then press [Enter]. 

4 Atthe Enter Target Path ID prompt, type the name of the directory to 
contain Tape Mate II software (the default is TMATE); then press 
[Enter]. If the directory does not exist, the INSTALL program prompts 
you to create the directory. Type ¥ and press [Enter] to create the 
directory; or type N and press [Enter] to stop the installation and 
return to the DOS command line. 

5 When prompted, type the letter of the drive containing the 
AUTOEXEC.BAT and CONFIG.SYS files and press [Enter]. 

6 At the Enter Company Name prompt, type the company name and 
press [Enter]. 


No 


— 
2 
@ 
= 
fa) 
2) 
@ 


87 


2 
OG 
= 
o 
e 


SC Shots: User Guide 


10 


11 


At the Enter User Name prompt, type your name and press [Enter]. 
When prompted to confirm the information, type ¥ and press [Enter] 
to confirm the information is correct; or type N and press [Enter] to 
return to the Enter Company Name prompt. 

When prompted to modify the AUTOEXEC.BAT file, type ¥ and 
press [Enter] to modify the file so Tape Mate II software can be started 
from any directory. The file is also changed to permit proper use of 
[Ctrl]-[Break]. The original file is saved in the root directory as 
AUTOEXEC.SAV. Type N and press [Enter] to make no changes to 
the AUTOEXEC.BAT file. 

Another message appears, prompting you to update the CONFIG.SYS 
file to add the following two lines: 


FILES=20 
BUFFERS=20 


These values are minimums. If the current values are larger than 20, 
Tape Mate II software makes no changes. If changes are made, then 
the original CONFIG.SYS file is saved in the root directory as 
CONFIG.SAV. Select Yes to make the changes; or No to make no 
changes. 

Press (Ctrl]-[Alt]-[Del] to re-boot the system before using Tape 
Mate II software. 


16.3 Configuring Tape Mate II Software for Your Device 


The first time you use Tape Mate II software, you must configure it for 
your backup device (i.e., tape drive, floppy drive, etc.). Follow these steps: 


1 


88 


Start Tape Mate II software by typing TMATE and pressing [Enter]. 
(If the AUTOEXEC.BAT file wasn’t modified during installation, first 
change to the directory containing Tape Mate IT software.) If the 
screen is distorted, see the note following these steps. 

A message indicates that no devices were found in the configuration 
file. Press [Esc] to open the Local Backup Device Selection dialog box, 
shown in Figure 25. 

The Current Backup Device field is set at No Device Selected. Press 
[Enter]. The Device Type Selection menu appears, listing supported 
devices. An arrow at the left of the menu indicates the list extends 
beyond the menu box. To scroll through the list, use the arrow keys or 
press [PgUp] and [PgDn]. 

Highlight the correct device, and press [Enter]. 

If Tape Mate IT software needs additional information for your device, 
a Device Configuration dialog box appears. The dialog box contains 
one or more of the following fields (see the example in Figure 26): 


44 


7 


16 Installation and Configuration 


Tape Mate II Friday September 17, 1993 11:29 am 


Local Backup Device Selection 


o Device Selected 


F7=Exit ENTER=Ed it 


| Device Type Selection Currently Selected Drivers 


Archive Anaconda 2888 QIC SCSI Tape 
Archive Python DDS DAT Drive 
frchive Viper 2068S Tape Drive 
Archive Viper 2125S Tape Drive 
Archive Viper 21588 Tape Drive 
Archive Viper 2525 Tape Drive 

4|DOS Disk Driver 


Figure 25 Local Backup Device Selection Dialog Box 


Compression—The default setting for this field is Default. With this 
setting, Tape Mate II software uses the media as it has previously 
been used: if the media was used with compression enabled, then 
compression is used; if the media was used with compression 
disabled, then compression is not used. To change this setting, 
select the Compression field; then select Disabled to disable 
compression, or Enable to enable compression. 


Device Configuration j 
Target Device SCSI ID: 
242.3 KB/Sec 


=Help F2=Accept F7=Exit Tab=Next Field 


Wangtek Model 628@HS DDS DAT 

Wangtek SCSI Streaming Tape Drive 
YD-7181 Series Streaming Cassette 
YD-7186 Series Streaming Cassette 


Figure 26 Device Configuration Dialog Box 


Target Device SCSI ID—The default setting for this field is Auto. 
With this setting, the driver uses the first device of this product type 
that it finds on the SCSI bus. To change the setting, press [Enter] 
to display the SCSI Bus ID menu; then select from the list of 
possible SCSI identification numbers, 0-6. 


89 


= 
> 
) 
= 
®) 
or 
Q 


Shots User Guide 


10 


11 Select Yes to save the changes, or No to abandon them. These changes 


Tape Speed—Select this field to list the supported tape speeds for the 
selected device; then select the appropriate tape speed. 


Tape Density—Select this field to list the options Default, Enabled, 
and Disabled, and select an option. 

Press [F2]. The Adapter Type Selection dialog box appears, with the 

single option: ASPI for DOS Driver. 

Press [Enter]. Another Device Configuration dialog box appears, 

displaying the Card Number field. 

In the Card Number field, the default is Card 0. If you have multiple 

adapters running under ASPI, you may need to select the appropriate 

card number for the device. First try card 0. If Tape Mate II software 

doesn’t recognize the device, try another card number up to 4. To 

select the card number, press [Enter] to display a menu of card 

numbers, and then select the card number. 

Press [F2]. The names of the selected device and driver (if applicable) 

appear in a box at the lower right of the screen. 

Press [F2] to save the configuration parameters. A Save Changes 

prompt appears. 


are saved in the configuration file. 


After you save the changes, the Configuration menu appears. You may 


re re ee ee 


337 7 49 


want to select Global Configuration Parameters from this menu to set 
global features, such as global run time options. You'll also use this menu if 
you later need to reconfigure Tape Mate II software—for example, if you 
switch to a different archive device. For information on the Configuration 
menu, see Chapter 25. 


To exit the Configuration menu, select Exit from the menu. This places 
you at the main menu. Subsequent chapters explain the options on this 
menu. To exit Tape Mate II software, select Quit. 


NOTE 


If the screen is distorted the first time you start Tape Mate II software, press 
[Ctri]-[Alt]-[Del] to reboot the system. Type TMATE /MONO and press [Enter]. 
This forces Tape Mate II software to operate in monochrome. Follow the 
steps above to configure Tape Mate II software. After step 11, when the 
Configuration menu appears, select Global Configuration. The Global 
Configuration Parameters dialog box appears. Change the Force 
Monochrome Display option to Yes and save the change by pressing [F2]. 
At the Save Changes prompt, select Yes. Otherwise, you'll have the same 
problem the next time you run the program. For more information on 
selecting the Force Monochrome Display option, see Chapter 25. 


2 
© 
= 
a 
: 


90 


3279 939 ¢ £ YF FF 7 7 


17 Getting Started 


This chapter describes Tape Mate II software basics, such as entering and 
exiting the main menu and selecting menu options. It also explains general 
principles for backing up data. 


17.1 Terms You Should Know 


Before using Tape Mate II software, review the following definitions. 
These terms appear throughout the Tape Mate II software and this 


manual. 


Archive Flag—A marker that indicates a file has been modified. When a 
file is modified, DOS “sets” the archive flag. As part of the backup 
procedure, you can have DOS reset (clear) the flag. DOS won’t set the 
flag again unless the file is later modified. In this way, the backup 
program can tell whether a file has changed since the last backup. 


Click(ing) On—A method of selecting items. To “click on” an item 
means to move the mouse pointer to the item and press and release the 
left mouse button. 


Dialog Box—A box (window) that appears on screen when Tape Mate II 
software requires additional information. You must enter information 
in the dialog box, either by selecting options or by typing text, before 
you can proceed with the operation. 


Session—A single backup operation. 


Volume—The medium (tape cartridge or removable disk) that stores the 
backed up data. 


17.2__Concepts 


To protect your data, you should back it up routinely. A typical weekly 
routine is to perform a full backup on Monday evening, when you back up 
all files and subdirectories on all drives. Then, at the end of each day 
Tuesday through Friday, perform an intermediate backup. 


— 
T 
<= 
O 
@ 


The most common types of intermediate backups are differential and 
incremental backups. Both types are based on the setting of the archive flag 
(“archive flag” is defined in the preceding section). In an incremental 
backup, the archive flag for each file is reset (cleared) after the file is copied, 
and the next backup copies only those files that have changed since the 
previous backup. If you are backing up files every week day, for example, 
the Tuesday backup copies only files that have changed since the Monday 
backup; the Wednesday backup copies only files that have changed since 
the Tuesday backup; and so forth. 


91 


g 
G 
= 
o 
2 


SC Shorts User Guide 


In a differential backup, the archive flag is not reset after a backup, and 
subsequent backups copy the cumulative changes since the last time the 
archive flag was reset. If you perform a full backup and reset the flag 
Monday evening, for example, performing a differential backup on the 
remaining weekdays has the following effect: on Tuesday evening, the 
backup copies all files that changed between Monday evening and Tuesday 
evening; on Wednesday evening, the backup copies all files that changed 
between Monday evening and Wednesday evening; and so forth. 


A differential backup takes longer to perform, since the amount of data 
being backed up increases as the week progresses. Restoration is quicker, 
however, because only two sessions must be restored to rebuild the system 
as completely as possible. Restore the full backup first, then the last daily 
differential backup. 


An incremental backup takes less time each day, since only those files that 
changed that day are backed up. But restoration takes longer, because you 
must restore the last full backup plus each subsequent incremental backup. 


Backup and restore times vary, depending on the speed of your computer 
system and the amount of data you are backing up or restoring. If you have 
a PC AT, for example, backing up 10 MB of data may take several 
minutes; and 120 MB, about 30 minutes. If you have a 386 or 486 
computer, backing up 10 MB should take about a minute; and 120 MB, 


about 15 minutes. 


17.3 Starting Tape Mate IT Software 


Start Tape Mate II software by typing TMATE and pressing [Enter]. (If 
the AUTOEXEC.BAT file wasn’t modified during installation, first 
change to the directory containingTape Mate IT software.) The company 
name, user name, and software serial number appear briefly; then the main 
menu appears. 


17.4 The Main Screen 


The main screen has two parts: the information header and the menu bar. 
The information header displays the name of the application, the day of 
the week, the date, and the current time. The menu bar lists the options 
that you can select: Backup, Restore, Verify, Utility, Configuration, and 
Quit. If you select Backup, Restore, or Verify, a dialog box appears. If you 
select Utility or Configuration, another menu appears; choosing one of 
those menu options displays a dialog box. Use the dialog boxes to provide 
the information necessary to execute the operations. 


17.5 Selecting Items 


Select menu options and dialog box fields in any of the following ways: 


92 


?1orddtdbgy3 


$a: 


j 


3 oYo' gst id 7] 


1 fj 


I 


17 Getting Started 


¢ Ifthe name of a menu option includes a bold letter, type the bold 
letter. 

¢ Use the arrow keys or [Tab] key to move the highlight from option 
to option (in a menu) or field to field (in a dialog box); then press 
[Enter] to choose the highlighted option or field. 


¢ Using the mouse, click on the option or field. 


17.6 Entering Information in Dialog Boxes 


Most Tape Mate II operations involve dialog boxes that require user 
input. In some dialog box fields, such as those for entering a password, you 
must type the information in the field. To do so, highlight the field and 


type the information. You can type over existing entries. 


With other fields, you must select options from another dialog box or a 
menu. To display that dialog box or menu, select the field. When the 
dialog box or menu appears, select the options you want. Multiple items 
can be selected in some dialog boxes by highlighting each item and 
pressing [F5]. To deselect an item, highlight it and press [F5] again. Press 


[F2] to accept your selections and return to the main dialog box. 


17.7 Keyboard Keys 


The following keyboard keys perform special functions in dialog boxes. 
When these functions are available, the key names and functions are listed 
at the bottom of the dialog box. 


[F1] Displays a help screen. 

[F2] Initiates or executes the operation; saves the information 

entered in the desired field or screen. 

[F5] Marks or unmarks a selection to be modified or deleted. 

[F7] Closes the dialog box without performing the operation. a 
The following keyboard keys are available at any time, even though they S 
are not listed at the bottom of the dialog box. = | 

Arrows Move the cursor through the fields. ot 

[Esc] Closes the dialog box without making any changes. cant 

[Enter] Selects the item; accepts text entered in a field and moves 

the cursor to the next field. 
[Tab] Moves the cursor to the next field. 


17.8 _Using the Mouse ) 


You can use a mouse compatible with the Microsoft Mouse Interface to 
select items in dialog boxes and menus. Just click on the item, using the 
left mouse button. Press the right mouse button to escape back to the 
previous menu without saving information. 


93 


2 
me 
= 
S 
e 


Shots User Guide 


You can select a function key listed at the bottom of a dialog box by 
clicking on the key name, unless the key name appears in reverse video 
(white background with black letters). In that case, you must press the 
designated key. 


17.9 Getting Help 


You can display information about a menu option or dialog box field by 


highlighting the option or field and pressing [F1]. 


17.10 Quitting Tape Mate IT Software 


Quit Tape Mate II software by selecting Quit from the main menu. 
When prompted to confirm you want to quit, select Yes. 


17.11 Do’s and Don'ts in Tape Mate II Software 


The following guidelines will help you avoid costly and time-consuming 


mis 


94 


es: 


Test the restore operation immediately, so if you ever need it, you'll 
know how to use it. Perform a small test backup with your com- 
puter running in its everyday configuration. Then restore files to a 
different directory and use the DOS COMPARE command to com- 
pare the original and restored data (see your DOS manual for in- 
formation on the COMPARE command). 

Retest Tape Mate IT software after installing any new memory-resi- 
dent software. 

Before overwriting data on an old backup tape, verify that you don’t 
need that data. Run the DOS CHKDSK command on your hard 
drive(s) to determine if any data is corrupted (see your DOS 
manual for instructions). If data is corrupted, first try using a disk 
utility to recover it. If the disk utility does not recover the data, 
however, you'll need to use the old backup tapes to restore the cor- 
rupted data. 

Perform at least two full backups (and verifies) before formatting or 
replacing a hard disk. 


Keep a set of backup volumes at an off-site location. 


j 


1:3) 3 f 7 


J 


: i oe 


37 9779 1°~4 J 


q 


| ee 


(4 


18 Backup Operation 


Backups can be attended or unattended. In an attended backup, you work 
interactively with the software to set up and execute the backup. In an 
unattended backup, Tape Mate II software performs the backup without 
operator intervention, using instructions stored in a file. This chapter 
describes how to perform an attended backup; for information on 
unattended backups, see Chapter 21. If you’ve never used a backup 
program, you might find it helpful to review Section 17.2. 


18.1 Overview 


The backup procedure involves these main steps: 
1 Selecting backup options. 


2 Executing the backup, providing any information requested by dialog 
boxes as the backup proceeds. 


Tape Mate II software provides great flexibility in selecting data for 
backup: 


¢ You can back up all drives, directories, and files; or limit the backup 
to drives, directories, and files you select. 

¢ You can select files and directories by specifying their directory 
paths or by specifying a date range. 

¢ You can back up only data that has changed since the last backup. 


You can also select the following special run time options: preview the 
backup operation without actually backing up any data; mark the original 
files as “archived”; delete the original files after they are backed up; encrypt 
the data; and verify the integrity of the backed up data. 


In Tape Mate II software, you can specify default backup parameters (file 
and directory selections and run time options) that apply to all drives. You 
can also set individual backup parameters for each drive. Default 
parameters are those you specify in the Backup Parameters dialog box (see 
Section 18.5.1). Individual backup parameters, on the other hand, are set in 
a Drive Backup Parameters dialog box for that drive (see Section 18.5.2). If 
you don’t set specific parameters for a drive, Tape Mate II software uses 
the default parameters. 


ES The main Backup Parameters dialog box and Drive Backup Parameters 
dialog box are similar and have similar names—a potential source of 
confusion. The best way to tell the difference is by the title at the top of the 
dialog box. If the dialog box is for a specific drive, the drive letter will be 
part of the dialog box title. 


95 


on 
° 
) 
= 
fs) 
CT 
a 


SC Shore: User Guide 


If you set default parameters and then specify different parameters for a 
drive, the drive parameters have precedence over the default parameters 
(for that drive only). If you have several drives, therefore, an easy way to set 
parameters is to specify as default those parameters that apply to most 
drives; then specify individual drive parameters only for those drives that 
have exceptions to the default parameters. 


If you often use the same run time options, you can change the software 
configuration to automatically display those options as the defaults in the 
Backup Parameters dialog box. For information on this feature, see Section 


2) sibs 


18.2 Performing a Backup 


To back up data, follow these steps: 


ES" Before performing the first backup, be sure Tape Mate II software is 


g 
G 
= 
S 
© 


configured properly for your system. See Chapter 25 for configuration 
instructions. 


1 Select Backup from the main menu. The Backup Parameters dialog 
box appears, as shown in Figure 27). 


Tape Mate II Thursday September 16, 1993 7:56 am 


| Backup Restore Verify Utility Conf iguration Quit 


} 


LANG CSE EE SUC USE BV Sd RIO EG TC TA 


| BACKUP PARAMETERS 
™ ee —— es a — 


Default Parameters 


Run Time Options: 


File Specification: Default 
Previously Backed Up Files: Included 
Since Date: 


Before Date: 
Session Title: “DATE “TIME Drive ~DRIVE 


Session Password: 
Session Retention Date: 


Source Drive(s): ALL Drives 
Fi=Help F2=Execute F7=Exit Tab=Next Field 
eee ee ee ey 


Figure 27 Backup Parameters Dialog Box 


2 Set any default parameters that you want to apply to all drives. For 
information on the Run Time Options field, see Section 18.3. For 
information on the session parameters, see Section 18.4. Information 
on the other fields, which are used for file selection, can be found in 
Section 18.5. 


[IS To perform a full backup, set the File Specification field to Default; the 
Previously Backed Up Files field to Included; and the Source Drive(s) 
field to All Drives. Leave the Since Date and Before Date fields blank. 


96 


18 Backup Operation 


3 To set different backup parameters for an individual drive, select the 
Source Drive(s) field. The Selected Drives dialog box and the Select 
Drive to Add dialog box appear. In the Selected Drives dialog box, 
select the letter of the drive whose parameters you want to change; a 
Drive Backup Parameters dialog box for that drive appears. Set the 
parameters, then press [F2] to save the changes. Any parameters you set 
override the defaults, for that drive only. Press [F2] again to return to 
the main Backup Parameters dialog box. For additional information, 
see Section 18.5.2. 

4 When you are satisfied with the parameters, press [F2] in the main 
Backup Parameters dialog box. The Select a Volume dialog box 
appears, as shown in Figure 28. (If you disabled the database, as 
described in Section 25.2, this dialog box doesn’t appear; skip to step 6 


to continue.) 


Tape Mate II Thursday September 16, 1993 8:16 am 


Volume: 


Figure 28 Select a Volume Dialog Box 


5 Select the name of the volume (i.e., the name of the tape or disk) to 
which you are backing up data. If the volume is new or isn’t listed, 
select New Volume. The Mount Archive Volume dialog box appears. 
If you selected a volume name, the dialog box indicates the name of the 
required volume; otherwise, it states simply “Mount Volume #1.” 

6 Insert the archival tape or disk in the tape or disk drive; then press [F2] 
to continue or [Esc] to abort the backup. 


oe Tape Mate II software scans the volume you inserted. Depending on 
the volume, you may need to complete additional steps, as described in 


steps 7 through 10 below. 


7 Ifyou insert a tape or floppy disk that needs to be formatted, you are 
prompted to initialize the volume. Select Yes to format the tape or 


DF 


os 
2 
Q 
= 
S) 
rT 
0) 


5 
O 
= 
1) 


QC Shrotc: User Guide 


floppy disk; if you select No, or if you insert any other type of 
unformatted media, the backup aborts. If you select Yes, a message 
warns you that the tape will be erased and prompts you to verify that 
you want to continue. Select Yes to format the tape, or No to abort 
the backup. 

8 Ifthe tape or disk has never been used with Tape Mate II software, 
the Volume Information dialog box appears. (This dialog box won’t 
appear if you disabled the database, as described in Section 25.2). The 
dialog box has these fields: 


Volume Title—You must type a volume title in this field. You should 
also label the tape or disk with this title. 


Storage Location—In this optional field, you can note where you will 
physically store the tape or disk when it’s not in use. 


Press [F2] to continue. A message prompts you to save the information 
in the database. In most cases, select Yes; but if you are performing a 
one-time backup for which no record is needed, select No. A volume 
header is written to the medium using the information in this dialog 
box. 

9 Ifthe tape or disk contains a session that has no retention date or an 
expired retention date, a message prompts you to append the new data 
to the selected volume. Above that message, a second message warns 
you that motappending will delete the listed sessions (those that have 
no retention date or an expired retention date). Select Yes to append 
the new data to the old data without overwriting the listed sessions. 
Select No to write the new data over the data in the listed sessions; the 
data in the listed sessions will be deleted, as will the corresponding 
session entries in the database. 

10 If the backup data cannot fit on the volume, you are prompted to 
“Mount Archive Volume #2” (i.e., insert another volume). If you are 
using tapes or floppy disks, you can insert an unformatted tape or disk 
in the drive; then repeat steps 7 and 8 to initialize the volume and 
specify a volume title. If you are using any other media, you must 
insert a formatted disk; then repeat step 8. 


Tape Mate II software scans the first source drive and source path being 
backed up and displays on screen the file and directory statistics for the 
current session (see Figure 29). Following this scan, the actual copying of 
files begins. As each subdirectory and each file is copied, its name, size, 
and date appear on screen. If an error occurs during the backup, an error 
message appears beneath the name of the file where the error occurred. 
The Percent field at the right of the screen displays the percentage of the 
backup that has been completed. 


98 


I 


oe ee | 


$11 


1 sf 


1 1 


oe oe 


|e re oe 


q 


18 Backup Operation 


Tape Mate II 


Thursday September 16, 1993 12:44 pm 


Volume: 1 
Percent: 17 
Size: 2,093,644 


C 118174 63-18-1992] 


Figure 29. Backup Status 


ZS Open files won’t be backed up unless you have enabled the Backup Open 
Files option in the Global Configuration Parameters dialog box (see Section 
25.2). At the end of the backup session, Tape Mate II software retries any 
files that were open. 


When the backup is completed, a summary of the operation appears on 
screen (for an example, see Figure 30). A summary statement also appears if 
the backup is aborted. In either case, press [Esc] to clear the screen and 
return to the main menu. 


Tape Mate II Thursday September 16, 1993 12:48 pm 


Drive: C: Root: Volume: i 
Files: 364 Dir: Percent: 108 
Elapsed Time: 66:63:83 Size: 11,875,884 


NTSCS INTRANTOR 
NTSCS INTRANTORNOLD 


— 
© 
@ 
= 
a) 
rT 
® 


Writing Directory Index 


Number of files Backed Up: 364 in 17 sub-directories 
Total number of files backed up: 364 in 17 sub-directories 
«x Press [Esc] to exit this screen + 


NTSCS ININS ITE 


Figure 30 Final Summary of Backup Operation 


99 


GC Shrorts User Guide 


18.3 Selecting Run Time Options 


The Backup Run Time Options menu, shown in Figure 31, appears when 
you select the Run Time Options field in the main Backup Parameters 
dialog box or in the Drive Parameters dialog box. The menu lists the 
following options: 


Preview Backup Option—Allows the backup steps to be viewed without 
affecting the source data or writing to the archive volume. This lets you 
validate the selected options. No other run time option can be selected 
when the Preview option is selected. Otherwise, an error message 
appears, and all but the preview backup option are disabled. 


Reset Backed Up Status—Resets the archive flag for each file as it is 
backed up. An archive flag indicates whether a file has been modified 
since it was last archived. When a file is modified, DOS sets the archive 
flag. Resetting a flag clears this flag, so that in future backups you can 
determine which files have been modified since the last backup. If this 
option is not selected, then no change is made to the archive flag for 
each file. See Previously Backed Up Files in Section 18.5 for how this can 
affect your selection of files for backup. 


Tape Mate II Thursday September 16, 1993 8:61 am 


| Backup Restore Verify Utility Conf iguration Quit | 
ane thet rH Seti f i Ht 


. Cr 


Default Parameters 
Run Time Options: 
File Specification: Default 
Previously Backed Up Files: Included 


Backup Run Time Options 
: —==—=IDATE “TIME Drive ~DRIVE 


Reset Backed Up Status 

Encrypt Data 

Delete Files After Backup 11 Drives 

Verify After Backup 
= it Tab=Next Field 


FS,ENTER=Toqgle Mark F2=Accept List 


9 
SG 
= 
S 
e 


Figure 31 Backup Run Time Options Menu 


Encrypt Data—Encrypts the data being stored on the archive media for 
security purposes. The encryption is performed at the data source and 
no unencrypted data is either transmitted over a LAN or stored on the 
archival volume. The encrypted data is automatically decoded when it 
is restored using the Restore operation. 


Delete Files After Backup—Deletes the original data upon the completion 


of a successful backup. You can use this option to “relocate” data to a 


100 


| | 


18 Backup Operation 


new drive or purge old files from a selected drive. Because this option 
results in the destruction of data, you are prompted to verify this 
selection. 


Verify After Backup—Select this option to perform a byte for byte 
comparison between the original data and the backup data after the 
backup is complete. 


You can select more than one run time option. To select an option, 
highlight it and press [F5] or [Enter]. Marked options flash on screen 
when highlighted. To unmark an option, highlight it and press [Enter] or 
[F5] again. Press [F2] to close the dialog box and save the list of options. If 
you select a combination that is not allowed, a message indicates the 
options are not compatible, and one or more of the options is disabled. 


When an option is selected, a letter representing that option appears in the 
Run Time Options field of the Backup Parameters dialog box (or Drive 
Backup Parameters dialog box, if you are setting drive-specific parameters). 
The letters that represent the options are listed below: 


P Preview Backup Option 
E Encrypt Data 

A Reset Backed Up Status 
D Delete Files After Backup 


cS A drive-specific setting overrides the default setting, for that drive only (see 


Section 18.1). 


18.4 Specifying Session Parameters 


The main Backup Parameters dialog box and the Drive Parameters dialog 
box allow you to specify the following session parameters: 


Session Title—The default session title is the current date and time (see 
Figure 27). To change the title, highlight the Session Title field and 
type a new name (e.g., Backup of server #1). You can insert a question 
mark to represent the drive letter; Tape Mate II software will 
automatically replace it with the letter of the drive being backed up. 


4 
D 
) 
= 
oO 
or 
a 


Session Password—Leave the Session Password field blank if you don’t 
want to assign a session-specific password. To assign a password, 
highlight the field, type a password of up to 6 characters (spaces are not 
allowed), and press [Enter]. (For security, the typed characters will not 
appear on screen.) A message prompts you to re-type the password to 
verify the spelling. Type the password again and press [Enter]. [fyou use 
a password, be sure to remember it, because the Verify and Restore 
operations will require it! 


101 


g 
G 
= 
a 
iS 


GC Short User Guide 


Session Rei ‘ution Date—You can type a date in this field to protect the 
session data from being overwritten until that date. Enter the date in 


the format MM-DD-YY or MM/DD/YY (e.g., 10/31/93 or 4/1/94). 


18.5 Selecting Drives, Directories, and Files 


When selecting data to backup, you can set default parameters that apply 
to all drives; and you can set drive-specific parameters for individual drives. 
Any drive-specific parameters override the default parameters, for those 
drives only. 


18.5.1 Setting Default Parameters 


To select default parameters, use the main Backup Parameters dialog box 
(see Figure 32). To display this dialog box, select Backup from the main 


menu. 


Tape Mate II Thursday September 16, 1993 8:61 am 


Restore Verify Utility Configuration 


| Default Parameters 
Run Tine Options: 
File Specification: Default 
Previously Backed Up Files: Included 
Since Date: 
Before Date: 
Session Title: YDATE ~TIME Drive ~DRIVE 
Session Password: 
Session Retention Date: 


Source Drive(s): All Drives 
Fi=Help F2=Execute F7=Exit Tab=Next Field 


HIRE Rn EIR DI coe RecA RnR SR Ibis OR ROI Ini Ri Re Le RR eee a 


Figure 32 Backup Parameters Dialog Box 


The following selections in the Backup Parameters dialog box let you 
choose drives, directories, and files for backup: 


¢ File Specification—Specify the paths of directories and files to be 
backed up. 

¢ Previously Backed Up Files—Include or exclude files that have 
been modified since the last backup. 

¢ Since Date and Before Date—Select files based on the date they 
were last saved. 

¢ Source Drive(s)—Select specific drives you want to back up. 


File Specification 
Select the File Specification field in the Backup Parameters dialog box to 
display the File Specification menu, shown in Figure 33. You can use the 


102 


18 Backup Operation 


menu options—Default, Script, Included Files, and Excluded Files—to 
select the directories and files that will be backed up on any drive for which 
drive rissa parameters have not been set. 


Pepa Te iy eee eee AE ae Th al ne Sentenber 16, 1993. 8:82 an || 


Default Parameters 
Run Time Options: None Selected 


File Specification: 


Previously Backed Up Files: Included 


File Specification 


Script 
Included Files 
Excluded Files All Drives 


“DATE ~TIME Drive ~DRIVE 


Fi=Help F2=Execute F7=Exit Tab=Next Field 
GC COE era eC aCe Susana | 


‘Fue 33 File Specification Menu 


Default—If Default is selected, all files meeting the other specifications in 
the Backup Parameters dialog box are backed up. The source path is 
assumed to be the root directory. 


Script—Choose Script to use an attended script file to select files. A script 
file isan ASCII text file that contains INCLUDE and EXCLUDE 
commands. These commands emulate user input on the Inclusive and 
Exclusive File Selections lists (see the following descriptions of the 
Include and Exclude options). If you use the same Inclusive and 
Exclusive lists often, using a script file saves the time of re-entering the 
same path and file specifications for every backup. For information on 
creating attended script files, see Chapter 22, Script Files. 


When you select Script, the Script Selection List menu appears, listing all 
the attended script files. Note that these script files have .NSS 

extensions. (If Tape Mate II software finds no script files, a message 
indicates that there are no script files in the list.) Select the script file to 
be used in the operation. 


—} 
° 
© 
= 
a) 
rT 
@ 


Included Files—Choose this option to generate a list of directories and 
files that will be backed up. When you select Included Files, the Path 
and File Name dialog box and Inclusive File Selections dialog box 
shown in Figure 34 appear. In the Path and File Name dialog box, type 
a full path, including directory and file name. The following examples 
show the type of paths that can be entered in this dialog box: 


103 


g 
G 
= 
S 
© 


GC SIrorts User Guide 


\* .* 
\*.Cc 
\TMATE \* . EXE 
\TMATE\FILE.NAM 


Verify Utility Conf iguration 


ENTER=Accept Entry 


Figure 34 Path and File Name Dialog Box 


As shown above, DOS wild card characters can be used to include 
complete groups of files or just files with the same file name extension. 


If you aren’t familiar with DOS wildcard characters, see your DOS 


reference manual. 


After typing the path, press [Enter]. The Path and File Name dialog box 
closes, and a message appears, inquiring whether the subdirectories of 
the specified path should be included in the backup. Select Yes to 
include subdirectories in the backup, or No to exclude them. If you 
select No, files in subdirectories are not backed up. 


After you select Yes or No, the path is listed in Inclusive File Selections 
dialog box, as shown in Figure 34. A column on the right side of the 
dialog box indicates whether subdirectories will be included (Y for yes, 
or N for no). 


To add another path to the list, press [Ins]. Repeat this process until the 
list in the Inclusive File Selections dialog box defines the directories and 


files to be backed up. 


To delete a path from the list, highlight it and press [Del]. To delete 
several paths, mark them using [F5] and then press [Del] to delete the 
group. To unmark a path, highlight it and press [F5] again. When 
prompted to verify the deletion, select Yes to delete the path or No to 
cancel the deletion. 


104 


18 Backup Operation 


To modify a path after it has been added to the Inclusive File Selections 
list, highlight the selection and press [Enter]. Make any required 
changes and press [Enter]. When the Process Subdirectories prompt 
appears, select either Yes or No. 


When the list is complete, press [F2] to accept the list. The Inclusive File 
Selections dialog box closes and the File Specification menu appears. 
Press [F2] to close the File Specification menu and return to the 

Backup Parameters dialog box. Or, select Excluded Files to create a list 
of files to exclude from the backup. 


Excluded Files—Use this option to exclude files or directories from being 
backed up. When you select Excluded Files, the Path and File Name 
dialog box and Exclusive File Selections dialog box appear. Adding, 
deleting, and modifying a path in the Exclusive File Selections dialog 
box is identical to the procedures just described in Included Files. 


The Included Files and Excluded Files options can be used together to add 
flexibility in specifying files to be backed up. When lists are generated by 
both the Included Files option and the Excluded Files option, Tape Mate 
II software compares the Inclusive File Selections list with the Exclusive 
File Selections list and generates a new list that excludes any path that 
appears on both lists. This generated list is then used in the backup. 


Previously Backed Up Files 


Use this feature to reduce the amount of time required to perform a 
backup by backing up only those files that have been modified since the 
last backup. If the files have not been modified since the last backup, they 
do not need to be backed up. 


The options for this field are Included and Not Included. To select an 
option, select the Previously Backed Up Files field, and then select the 
option. 


If you select Included, all files meeting the drive, path, and file 
specifications listed in previous fields are backed up. The setting of the 
archive flag for each file is ignored. If you select Not Included, the program 
looks at the archive flag for each file that meets the drive, path, and file 
specifications listed in previous fields. Only files whose archive flag is set, 
indicating the file has changed since the last backup, are backed up. If the 
archive flag is clear, the file has not been modified since the last backup, 
and the file is not backed up. 


Use of the Not Included option has no effect on the Reset Backed Up 
Status option that resets the archive flag (see Section 18.3 for information 
on Reset Backed Up Status). However, the setting of the Reset Backed Up 
Status option does affect the Not Included option. If Reset Backed Up 


= 
D 
Cy) 
= 
O 
or 
Q 


105 


2 
O 
= 
SD) 


WCShraotc User Guide 


Status was not selected during the previous backup, the archive flag was 
not cleared. In this case, the current backup may copy files that haven’t 
been modified since the previous backup. 


Since Date and Before Date 


You can use the Since Date and Before Date fields in the Backup 
Parameters dialog box (or Drive Backup Parameters dialog box) to back up 
files that have dates within a specified time period. If you type a date in the 
Since Date field, only files dated on or after the specified date are backed 
up. If a date is entered in the Before Date field, only files dated on or 
before the specified date are backed up. The date format is MM-DD-YY or 
MM/DD/YY; preceding zeros are not required for single digit days or 
months. To enter January 20, 1994, for example, 

type: 1/20/94. 


The Since Date and the Before Date fields can be used together to select a 
narrow range of files to back up. If the date specified in the Before Date 
field is more recent than the date specified in the Since Date field, only 
files dated on or between the two specified dates are backed up. 


Source Drive(s) 


The default selection in the Source Drive(s) field is All Drives. With this 
selected, all files meeting file selection criteria are backed up on all drives. 
To specify the drives you want backed up, select the Source Drive(s) field. 
The Select Drive to Add dialog box appears, listing the valid drives (see 
Figure 35). To the left is the Selected Drives dialog box. In the Select Drive 
to Add dialog box, select the letter of the drive you want to back up. The 
drive letter appears in the Selected Drives dialog box. To add a second 
drive, press [Ins], and select another drive. When finished, press [F2] to 
save the list and return to the Backup Parameters dialog box. 


You can also use this field to select different backup parameters for 
individual drives. See the following section for details. 


18.5.2 __ Setting Different Parameters for Different Drives 


If you don’t want the default parameters in the Backup Parameters dialog 
box to apply to all drives, you can select drive-specific parameters for the 
drives that should differ. The drive-specific parameters override the default 


parameters for the specified drive only. 


To set drive-specific parameters, select the Source Drive(s) field in the 
Backup Parameters dialog box. The Selected Drives dialog box and Select 
Drive to Add dialog box appear (see Figure 35). In the Selected Drives 
dialog box, select the letter of the drive whose parameters you want to set 
(if you haven’t yet selected a drive, the Selected Drives dialog box is empty; 
see Source Drives in Section 18.5.1 for instructions on selecting a drive). 


106 


$33) 39 137 3 


$59) 9 9 J J) 7 


j 


J 


J 


} 


18 Backup Operation 


Tape Mate II 


Thursday September 16, 1993 7:58 am 


Verify Utility Configuration 


EEL Cee 


Default Parameters 
Run Time Options: None Selected 
File Specification: Default 


= Drive To Add 


| PE |E Drive “DRIVE 


| 
————— — 4 


Session Retention Date: 


Source Drive(s): 
| Fi-Help F2=Execute F7=Exit Tab=Next Field 


INS=Insert DEL=Delete F2=Accept List ENTER=Modify 


Figure 35 Select Drive To Add Dialog Box 


The Drive Backup Parameters dialog box for that drive appears. Use this 
dialog box to set the different file selection criteria for the selected drive 


(see Figure 36). 


Tape Mate II 


Thursday September 16, 1993 7:59 am 


Backup Restore Verify Utility Configuration Quit | 


Drive C: Backup Parameters | 
Source Path: SE | 
Run Time Options: None Selected 


File Specification: Default 


Previously Backed Up Files: Included 
Since Date [MM/DD/YY]: 
Before Date (MM/DD/YY1: 


Session Title: 
Session Password: 
Session Retention Date: 


“DATE u~TIME Drive ~DRIVE 


F2=Execute F7=Exit Tab=Next Field 


Fi-Help 


“4 
> 
Q 
= 
2) 
rT 
Q 


Figure 36 Backup Parameters Dialog Box 


The Drive Backup Parameters dialog box is similar to the main Backup 
Parameters dialog box described earlier. Only the Source Path and Tree 
Select options differ; the remaining parameters function as described earlier 
in this chapter. 


Source Path—Type the name of the path from which the backup 
operation is to begin copying data for this drive. The root directory is 
the default for this field, which results in the entire drive being backed 


107 


GC Shores User Guide 


up. To back up only part of a drive, enter a specific path name in this 


field. 


Tree Select—This option appears on the File Specification menu, which 
appears when you select the File Specification field. The other menu 
options are Default, Included Files, and Excluded Files, which are 
described in Section 18.5.1. 


Select Tree Select from the File Specification menu to display a directory 
tree of the selected source path. If you select a directory or subdirectory 
name, a list of all files in the highlighted directory appears (see 


Figure 37). 


When the parameters have been set for one drive, press [F2] to save and 
return to the Selected Drives dialog box. You can select another drive, and 
define its backup parameters, or press [F2] to return to the main Backup 
Parameters dialog box. 


| Tape Mate II 
Selected Drive: C: 
Selected Path: \‘\ 


Thursday September 16, 1993 8:68 am 


et | 


5 66-28-93 

85-18-93 

66-61-93 

SYSSERR . DTA 67-24-98 
SYSSHELP .DTA 67-24-98 
SYSSMSG .DTA 67-24-98 
86-25-93 

86-82-93 

86-82-93 

66-88-93 

66-26-31 

64-82-92 

86-26-91 

86-23-93 

86-23-93 


BERSRRNRESTSRS 


ENTER,FS=Toqqle Mark INSERT=Mark ALI DELETE=Unmark All F2=Accept 


Figure 37 Tree Selection 


2 
G 
= 
S 
e 


108 


19 Restore Operation 


To restore backed up data to a hard disk, use the Restore option on the 
main menu. Restore copies backed up files, along with the directory 
structure, from an archive volume (tape or disk) to a specified disk drive 


and directory. 
19.1 Restoring Data 


Restoration involves setting the restoration parameters and executing the 
restoration, as described in the following steps. For details on the 
restoration parameters, refer to Section 19.3. 

1 Select Restore on the main menu. The Restore Parameters dialog box 


appears (see Figure 38). 


Tape Mate II Thursday September 16, 1993 8:16 am 


iH Destination Drive: 


Destination Path: 
| Run Time Options: None Selected 
| Source Session: <Currently Mounted Volume> 
| Since Date (MM/DD/YY: 
i} Before Date [MM/DD/YY]: 


Fi=Help F2=Execute F7=Exit Tab=Next Field 


Figure 38 Restore Parameters Dialog Box 


2 Inthe Destination Drive field, type the letter of the drive where the 
data is to be copied. 

3 In the Destination Path field, type the name of the directory or 
subdirectory to which Tape Mate II software will begin restoring the 
archived data (see Section 19.3.2, Destination Path). 

4 Choose any run time options you want by selecting the Run Time 
Options field, and then selecting one or more options from the Restore 
Run Time Options menu (see Section 19.3.3, Run Time Options). 

5 To select a specific session for restoration, select the Source Session 
field, and then select the session you want (see Section 19.3.4, Source 
Session). 


109 


| 
> 
CY 
<= 
a) 
rT 
) 


9 
SG 
= 
S 
e 


GCShrots: User Guide 


6 


To select files dated within a specific time period, type the date or dates 
in the Since Date and Before Date fields. Use the format MM-DD-YY 
or MM/DD/YY (see Section 19.3.5, Since Date and Before Date). 

When you are satisfied with the parameters, press [F2]. A Mount 
Archive Volume dialog box appears. The dialog box states the name of 
the required volume if you selected a session in step 5; otherwise, it says 
simply “Mount Volume #1.” 

Insert the volume (tape or disk) in the archive drive, and press [F2]. 

If you didn’t select a session in step 5, the Session Header dialog box 
and Confirm Session I.D. menu appear (see Figure 39). The Session 
Header dialog box displays information on the first session on the 
volume. If you don’t want to restore this session, select Skip This 
Session from the Confirm Session I.D. menu. Information on the next 
session then appears in the dialog box. When the dialog box displays 


the session you want restored, select Use This Session. 


Thacadany Reareshec 465 1993 “42: 48 pm 


Volume Title: 

C: Drive —- Selected Directories 

Source Drive/Path: CzN 

Volume Creation Date: Thursday Sept. 16, 1993 12:44:85 pm 
Session Number: 1 


T Se 
Skip This Tousen 
All Done, Exit 


Figure 39 Confirm Session |.D. Menu 


10 If the session you selected in step 5 or step 9 requires a password, a 


message prompts you for the password (see Section 18.4 for information 
about passwords). Type the password; on screen it is replaced by 
asterisks for security reasons. If you enter the password incorrectly, you 
are prompted for it again. The restoration aborts after three failed 
password attempts. 


Tape Mate II software begins restoring the data. If the archive device 
supports Quick File Access (QFA), a message indicates that the QFA 
process is being performed (QFA is a feature that provides a higher-speed 


file retrieval from supporting tape devices). 


As the restoration proceeds, the status is shown in the Restore Status 
screen. As shown in Figure 40, a percent (%) complete number appears at 


110 


19 Restore Operation 


the top right-hand side of the screen. The percentage changes as the 
restoration proceeds. As each file is copied, its path, name, size, and date 
appear. If an error occurs, an error message appears beneath the file 
associated with the error, and the processing continues. 


Tape Mate II Thursday Sentashor fae 1993 2:01 


Root: Volume: 1 
Dir: : Percent: 188 
68: 64: 29 Size: 11,875,864 


Number of files restored: 364 in 1 sub-directories 
#3 Press [Esc] to exit this screen ++ 


NTSCS INADAPTEC 
NTISCSININSITE 


Figure 40 Restore Status 


When the session is restored, a summary statement appears—unless you 
selected a session in step 9 and other sessions follow that session on the 
volume. In that case, the Session Header dialog box and Confirm Session 
I.D. menu reappear (see Figure 39). If you don’t want to restore another 
session, select All Done, Exit. If you select another session, the Restore 
Parameters dialog box reappears so that you can change the Destination 
Drive and Destination Path fields for the new session. 


19.2 Restoring a Multiple-Volume Session 


The procedure for restoring a multiple-volume session is similar to that for 
a single-volume session. Insert the first volume, and follow the steps listed 
in Section 19.1 to set the restoration parameters and execute the 
restoration. When all data on the first volume is restored, you are 
prompted to mount (i.e., insert) volume #2. Insert the volume and press 
[F2] to continue. If more than two volumes are required, you are 
prompted for each additional volume. 


19.3 Setting the Restoration Parameters 


The Restore Parameters dialog box, shown in Figure 38, appears when you 
select Restore on the main menu. Use this dialog box to specify restoration 
criteria, such as run time options or a specific session you want to restore. 
The following sections describe the fields in this dialog box. Note that the 
first two fields, Destination Drive and Destination Path, are required 
information. 


4 
2 
g 
= 
a) 
cr 
@ 


111 


2g 
G 
= 
a 
© 


GC Shrotc: User Guide 


19.3.1 Destination Drive 


The information in this field is required. Type the letter of the drive where 
the data is to be copied. The drive can be any valid DOS drive (A to Z), 
including re-directed drives and RAM drives. 


19.3.2 Destination Path 


The information in this field is required. Type the name of the directory or 
subdirectory to which Tape Mate II software will begin restoring the 
archived files. 


To restore the directory structure and files to their original locations, enter 
the same path specified as the source path in the backup. If you selected 
drive-specific parameters, this is the path specified in the Source Path field 
of the Drive Backup Parameters dialog box (see Section 18.5.2). If you used 
the default backup parameters, this is the root directory (designated by a 
backslash \). Files can be relocated on the hard disk by entering a different 


source path than was used in the backup. 


19.3.3 _Run Time Options 


When you select Run Time Options from the Restore Parameters dialog 
box, the Restore Run Time Options menu appears. Shown in Figure 41, 
the menu lists the following options: Restore Preview Option, Restore 


Newest Option, Restore READ ONLY Option, and Prompt User for 


Restore. 


Tape Mate II \ Thursday September 16, 1993 8:22 an 


Verify Utility Configuration Quit | 


Destination Drive: 
| Destination Path: 
| Ru fe Selected | 

Restore Run Time Options 
| Sol- == ————SSSSSSEEEEEEErrently Mounted Volume> 


estore Preview Option 
Resto Newest Option 


re 
Restore READ ONLY Option 
Prompt User for Restore 


Fi=Help F2=Execute F7=Exit Tab=Next Field 
FS,ENTER=Toggle Mark F2=Accept List 


Figure 41 Restore Run Time Options Menu 


You can select more than one option. To select an option, highlight it and 


press [Enter] or [F5]. Marked options flash on screen when highlighted. 


112 


19 Restore Operation 


To unmark an option, highlight it and press [Enter] or [F5] again. Press 
[F2] to close the dialog box and save the list of options. 


When an option is selected, a letter representing that option appears in the 
Run Time Options field of the Restore Parameters dialog box. The letters 
that represent the options are listed below: 


P Restore Preview Option 

N Restore Newest Option 

R Restore READ ONLY Option 
Q Prompt User for Restore 


Restore Preview Option—This option allows the restoration to be 
previewed without writing the data to the destination drive and 
destination path. You can use this option to validate the selected 
options. 


Restore Newest Option—Use this option to restore only those files for 
which the archived version has a later date than the version in the 
destination drive and destination path. If the file exists on the 
destination drive and has a more recent date than the version on the 
archive media, that file will not be restored. 


Restore READ ONLY Option—Use this option to restore read-only files. 
The normal mode is to honor the read-only attribute and not restore 
the read-only files. By selecting this option, you can restore read-only 


files. 


Prompt User for Restore—For added security during a restore operation, 
select this option to require a confirmation before overwriting and 
replacing an existing file. A yes or no response must be entered for each 
overwrite case. In this manner, you have manual override on a 


file-by-file basis. 
19.3.4 Source Session 


You can select Source Session to specify which session will be restored. 
When you select this option, the Select a Session menu appears, listing all 
sessions recorded in the database (see the example in Figure 42). If previous 
backups were performed with the database disabled, the list is empty except 
for the default option, Currently Mounted Volume. 


From the Select a Session menu, select the session you want restored. The 
File Specification menu appears. If you selected a specific session, the menu 
contains these options: Default, Script, Included Files, Excluded Files, and 
Tree Select. If you selected Currently Mounted Volume, the menu doesn’t 
include Tree Select. 


113 


—_ 
© 
i) 
= 
2) 
ms 
i) 


g 
G 
= 
S 
e 


SCShrotc: User Guide 


- Sa ae te es a wee a ne ee | 
Tape Mate II V1.16 Wednesday October 6, 1993 1:34 pm 


Backup Restore Verify Utility Configuration Quit 


RESTORE PARAMETERS 


| 
Run Time Options: None Selected 


Source Session: <Currently Mounted Volume> 
Since Date [MM/DD/YY]: 
Before Date [MM/DD/YY1: 


Fi=-Help F2=Execute F7=Exit Tab=Next Field 


Figure 42 Select a Session Menu 


Default—Select Default to restore all files in the session. 


Script—Select this option to choose an attended script file that specifies 
the files to be restored. A script file is an ASCII text file containing 
INCLUDE and EXCLUDE statements. When you select Script, a 
menu of all attended script files appears. Select a script file from this 
menu. Instructions for creating a script file can be found in Chapter 22. 


Included Files—Use this option to generate a list of directories and files to 
be restored. For information on using this option, see Included Files in 


Chapter 18. 


Excluded Files—Use this option to exclude files from being restored. This 
feature is explained in Excluded Files in Chapter 18. 


Tree Select—Selecting this option displays a directory tree of the selected 
session. See Tree Select in Section 18.5.2 for details on this feature. 


19.3.5 Since Date and Before Date 


The Since Date and Before Date fields in the Restore Parameters dialog 
box let you restore files dated within a specified time period. If you typea 
date in the Since Date field, files with dates on or following the specified 
date are restored. Enter a date in the Before Date field to restore files with 
dates on or before the date specified. The format for entering the date is 


MM-DD-YY or MM/DD/YY (e.g., 10/31/99, or 1-1-94). 


The Since Date and the Before Date fields can be used together to select a 
narrow range of files to restore. If the date specified in the Before Date 
field is more recent than the date specified in the Since Date field, only 
files with dates the same as or between the two specified dates are restored. 


114 


20 Verify Operation 


Use the Verify option to compare byte for byte the data that was written 
during the backup or restore operation with the original files (if you’re 
verifying a backup) or the archived files (if you’ re verifying a restoration). 
Any discrepancies are reported on a file-by-file basis. If a discrepancy is 
noted, you can choose to continue or abort the verification. 


Follow these steps to verify data after a backup or restore operation: 
1 Select Verify on the main menu. The Verify Parameters dialog box 
appears, as shown in Figure 43. 


Tape Mate II Thursday September 16, 1993 8:23 an 


<Currently Mounted Volume> 


Fi=Help F2=Execute F7=Exit Tab=Next Field 


Figure 43 Verify Parameters Dialog Box 


2 Inthe Source Drive field, type one of the following: 
If verifying a backup operation—Type the letter of the drive that 


contains the original data. 


If verifying a restore operation—Type the letter of the drive 
containing the restored data. 


ash 
D 
Q 
= 
(®) 
or 
Q 


The drive can be any valid DOS drive that is physically attached, 
including virtual drives or RAM drives. 

3 Inthe Source Path field, type the name of the directory where Tape 
Mate II software will begin verifying data: 


If verifying a backup operation—You should specify the root directory 
(/) if you used default backup parameters to back up the data. If you 
selected drive-specific backup parameters, you should enter the 


115 


GC SP iorts User Guide 


same path specified in the Source Path field of the Drive Backup 
Parameters dialog box (see Section 18.5.2). 


If verifying a restore operation—You should enter the path specified 
in the Destination Path field of the Restore Parameters dialog box. 

4 Press [F2]. The Select a Session menu appears, listing all sessions 
recorded in the database. If previous backups were performed with the 
database disabled, the list is empty except for the default option, 
Currently Mounted Volume. (If the database is currently disabled, this 
menu doesn’t appear; skip to step 6 to continue.) 

5 Select a session. If the session you want verified isn’t listed, select 
Currently Mounted Volume. A Mount Archive Volume dialog box 
appears. The dialog box states the name of the required volume if 
you selected a session in step 5; otherwise, it says simply “Mount 
Volume #1.” 

6 Insert the correct volume (tape or disk) in the archive drive, and press 
[F2]. 

7 Ifyou selected Currently Mounted Volume in step 5, the Session 
Header dialog box and Confirm Session J.D. menu appear (see Figure 
44). The Session Header dialog box displays information on the first 
session on the volume. If you don’t want to verify this session, select 
Skip This Session from the Confirm Session I.D. menu. Information 
on the next session then appears in the dialog box. When the dialog 
box displays the session you want verified, select Use This Session. 


Tape Mate II Thursday September 16, 1993 2:62 pm 


| Backup Restore Verify Utility Configuration  — Qui Quit | 


SERRE EERE SEES 


i} Volume Title: 
C: Drive —- Selected Directories 
Source Drive/Path: C:N 
Volume Creation Date: Thursday Sept. 16, 1993 12:44:85 pm 
Session Number: eA 


9 
G 
= 
8 
e 


Skip This Seuatan 
All Done, Exit 


Figure 44 Confirm Session |I.D. Menu 


8 Ifthe session you selected in step 5 or step 7 requires a password, a 
message prompts you for the password (see Section 18.4 for information 
about passwords). Type the password; on screen it is replaced by 
asterisks for security reasons. If you enter the password incorrectly, you 


116 


20 Verify Operation 


are prompted for it again. The verify operation aborts after three failed 
password attempts. 


Tape Mate II software begins verifying the data. As the verification 
proceeds, the status is shown in the Verify Status screen. As shown in 
Figure 45, the screen shows the percentage complete, information on the 
files and directories being compared, the real-time number of compared 
bytes, and error information. The status numbers change as the verification 
proceeds. 


Thursday September 16, 1993 2: 


| 
| 


File Count: 

File ID: 

Path ID: 

File Size: 8726 188 
Bytes Verified: Bytes Not Verified: 
Verify Errors: 8 


cS if multiple volumes were used for the session that is being verified, a 
message prompts you to mount (insert) the next volume. 


If Tape Mate II software detects a discrepancy between the archived data 
and the source or restored data, an error message appears, along with a 
continue or abort query. If you continue, the Bytes Not Verified field is 
updated to reflect the size of the rest of the current file. Tape Mate II 
software assumes that at the point of the discrepancy, the remaining data in 
that file will not compare either. The number of errors, shown in the 


Verify Errors field, is also updated. 


When the verification is complete, a summary statement appears—unless 
other sessions follow that session on the volume. In that case, the Session 
Header dialog box and Confirm Session I.D. menu reappear (see Figure 
44). If you don’t want to verify another session, select All Done, Exit. If 
you select another session, the Verify Parameters dialog box reappears so 
that you can change the Source Drive and Source Path fields for the new 
session. 


=r 
D 
Q 
= 
O 
pe 
Q 


LE? 


fr £rtee:t ie & ££ Er EEE ££ Gc ek t bee ct Gt tlk 


! User Guide 


118 


]] QaoW sdb] 


21 Unattended Operations 


An unattended operation is a backup, restore, or verify operation 
performed using a script file and accomplished without user intervention. 
There are two types of unattended script operations: immediate and 
delayed. An immediate operation is performed from the DOS command 
line. A delayed operation is set up within Tape Mate II software and is 
executed at a specified time without operator intervention. 


The script file used in the unattended operation is an ASCII text file 
containing Tape Mate II Script Language commands. Instructions for 
creating an unattended script file can be found in Chapter 22. 


21.1 Immediate Unattended Operations 


An immediate unattended operation is performed by typing TMATE on the 
DOS command line, followed by the name of the script file. The file name 
can be entered with or without the file name extension. To execute the 
script file BACKUP1.NSF, for example, type TMATE BACKUP1 and 
press [Enter]. 


If the AUTOEXEC.BAT file was modified when Tape Mate II software 
was installed, the command can be entered from any DOS prompt. If the 
AUTOEXEC.BAT file was not modified, change to the directory and 
drive (if a multiple drive system) where Tape Mate II software is located 
before entering the command. 


The commands in the specified script file are executed immediately. When 
the commands have been completed, Tape Mate II software closes and 
the DOS prompt reappears. 


If the operation fails, an error message appears. If the Log History option 
on the Global Configuration Parameters dialog box is enabled, you can 
check the log history file for clues to the reason for the failure. 


21.2 Delayed Unattended Operations 


To set up and schedule a delayed operation, use the Unattended 

Parameters option on the Utility menu. The procedure involves these 

steps, which are described in the following sections: 

1 Scheduling the start time. 

2 Activating the Tape Mate IT scheduler. 

3 Enabling the Log History option on the Global Configuration 
Parameters dialog box. 


— 
© 
@ 
= 
a) 
ct 
@ 


119 


SC Shore: User Guide 


21.2.1 Scheduling the Start Time 


Follow these instructions to schedule the operation: 
1 Select Utility from the main menu. The Utility menu appears. 


2 Select Unattended Parameters. The Unattended Parameters dialog box 
appears, as shown in Figure 46. 


Thursday September 16, 1993 8:25 am 


Tape Mate II 


Database Resources 
Initialize Media 
Retension Media 


SISTA TATA 


ae 
4 | if 


Unattended Parameters 


i] Operation Frequency: 

i] Start Time Chh:mm:ss): 

‘i Day of Week (Weekly Only): 
Start Date (One Time Only): 

#8 Script File Name: 


One Time Only 
86:88:88 


Sunday 
9-16-1993 


Fi=Help F2=Accept F7=Exit Tab=Next Field 


Figure 46 Unattended Parameters Dialog Box 


3 Select the Operation Frequency field. In the Operation Frequency 
menu that appears, select the desired frequency. 

4 Inthe Start Time field, type the time for the unattended operation to 
begin. Use the HH:MM:SS time format, where HH represents the 


hour (use a 24-hour format), MM represents minutes, and SS 


120 


= represents seconds. If the unattended operation is to begin at 8:05 pm, 
© for example, enter 20:05:00. The leading zeros in single digit hours, 
S minutes, or seconds are required. 
a, The clock hours and corresponding 24-hour time are given below: 
-— midnight 00:00:00 noon 12:00:00 

1:00 am 01:00:00 1:00 pm 13:00:00 

2:00 am 02:00:00 2:00 pm 14:00:00 

3:00 am 03:00:00 3:00 pm 15:00:00 

4:00 am 04:00:00 4:00 pm 16:00:00 

5:00 am 05:00:00 5:00 pm 17:00:00 

6:00 am 06:00:00 6:00 pm 18:00:00 

7:00 am 07:00:00 7:00 pm 19:00:00 

8:00 am 08:00:00 8:00 pm 20:00:00 

9:00 am 09:00:00 9:00 pm 21:00:00 

10:00 am 10:00:00 10:00 pm 22:00:00 

11:00 am 11:00:00 11:00 pm 23:00:00 


| 21 Unattended Operations 


5 If Weekly is the specified frequency, move the cursor to the Day of 
Week field. Press [Enter] to display the Day of Week menu; then select 
a day of the week. 

6 The Start Date field displays today’s date. To change the date, type a 
new date using the MM-DD-YY format. Preceding zeros are not 
required in the date format. If the unattended operation is to begin on 
October 20, 1993, for example, enter 10-20-93. 

7 Select the Script File Name field to list the available script files, and 
select a file. Script files have an .NSF file name extension. The default 
directory for the unattended script files is the directory that contains 
Tape Mate II software. If the script file was saved to a different 
directory, move the file to the directory containing Tape Mate II 
software. 

8 Press [F2] to save the information in the Unattended Parameters dialog 
box. 


9 Select Exit on the Utility menu to close the menu. 


21.2.2 Activating the Tape Mate II Scheduler 


To support an unattended operation in a single-tasking MS-DOS 
environment, Tape Mate II software supplies a scheduler, which is a 
Terminate and Stay Resident (TSR) application. The scheduler must be 
loaded in memory for the delayed operation to execute. The scheduler 
continually monitors the system clock and compares it to the start time 
specified in the Unattended Parameters dialog box. At the specified time, 
the scheduler starts Tape Mate II software and executes the commands in 
the specified script file. 


The scheduler is a program called START.EXE. You can load this TSR 
application into system memory using the AUTOEXEC.BAT file; or you 
can run it before leaving work for the day by typing START at a DOS 
prompt and pressing [Enter]. 


START will reside in system memory until the system power is turned off 
or until START is removed. START can be removed from system memory 
by pressing [Ctrl]-[Alt]-R simultaneously. 


— 
T 
2 
= 
7 
a 


The delayed unattended operation can be executed immediately, regardless 
of the start time specified in the Unattended Parameters dialog box, by 
pressing [Ctrl]-[Alt]-S simultaneously. 


21.2.3 __ Enabling the Log History Option 


Enable this option in the Global Configuration Parameters dialog box. 
Refer to Section 25.2 for instructions. 


121 


[ 


! User Guide 


, £ 


L 


i 


i 


Et EEE 


Lf £E EEE FE EEE EL 


I] aIOW eB] 


l 


122 


l 


[aay 
= 22 Script Files 
xa Script files let you perform archive operations while you are away from 
your computer. They are particularly useful for running routine backups 
me during off-hours, when no one is using the system. Such operations are 
called unattended operations, and the corresponding script file is called an 
— __ unattended script file. Unattended script files contain commands that 
specify all parameters in a backup, restore, or verify operation. 
= Even if you conduct most archive operations within Tape Mate II 
; software, in interactive mode, you may find script files useful—especially if 
_ you often use the Included Files and Excluded Files options to select files 
a (see Section 18.5). By specifying the included and excluded paths and files 
in a script file, you don’t need to enter them over again every time you 


perform an operation. Script files used within Tape Mate II software are 
called attended script files. Unlike unattended script files, they include only 
= two commands: INCLUDE and EXCLUDE. 


This chapter explains how to create unattended and attended script files. 
For information on scheduling and executing an unattended script file, see 
Chapter 21. For information on using an attended script file within Tape 
= Mate II software, see Section 18.5. 


~ 22.1 Creating a Script File 


You can create a script file in Tape Mate II software or in an ASCII text 
editor. To create a script file in Tape Mate IT software, follow these steps: 


at 1 Select Utility from the main menu. 
= 2 Select Edit Script File from the Utility menu. = 
3 Select Unattended Script or Attended Script. The Select Script File S 
menu appears. @ 
ie 4 Press [Ins]. You are prompted to enter a file name. = 
5 Typea file name of up to 8 alphanumeric characters, and press [Enter]. o. 
eas (Don’t include a file name extension; the extension .NSF is O 
_ automatically added to unattended script files, and .NSS to attended = 
eal script files.) A blank screen appears, ready for you to enter script 
| commands. 
— 6 Type the commands. See Section 22.4 and Section 22.5, for detailed 
~ instructions. You can also display a Help screen by pressing [F1]. 
ee 7 When finished, press [Esc]. The Save Changes prompt appears. 
- 8 Select Yes to save the file and exit, or No to exit the file without saving 
it. Files are automatically saved in the directory containing Tape 
= Mate IT software. 
123 
La 


iJ 


GC Shot: User Guide 


You return to the Select Script File menu, which now lists the name of the 
script file you created. Even if you selected No when prompted to save the 
file, the name of the (empty) script file still appears in this menu. To delete 
it, see Section 22.3. 


cS if you create a script file in an ASCII text editor, be sure to save it in the 


g 
G 
= 
S 
e 


directory containing Tape Mate II software and to include the 
appropriate file name extension: .NSF for unattended script files, and .NSS 
for attended script files. 


22.2 Editing a Script File 


To edit a script file in Tape Mate II software, follow these steps: 

1 Select Utility from the main menu. 

2 Select Edit Script File from the Utility menu. 

3 Select Unattended Script or Attended Script. The Select Script File 
menu appears, listing script files in the directory that contains Tape 
Mate II software (see Figure 47). If you selected Attended Script, the 
list displays only the attended script files. If you selected Unattended 
Script, it displays only unattended script files. 


Tape Mate II Friday September 17, 1993 6:56 am 


| Backup Restore Verify Utility Conf iguration Quit 


rf 


as a oy ante ie Initialize Media 
BREEN EH RRNA eee i| |Retension Media 
eat: “| |Eject Media 
te =. 1 fia ded Parameters 
ript File 
Information 


Tag SEE A Ea RE SE RT OY 


eT are cana Tones wee Ten cae ee aa aw ee ae 


nid iL 
» delete 


Figure 47 Select Script File Menu 


4 Select the name of the script file you want to edit. The file appears on 
screen. 

5 Edit the file. For information about the script commands, see Sections 
22.4 and 22,5. You can also display a Help screen by pressing [F1]. 

6 When finished, press [Esc]. If you changed the file, the Save Changes 
prompt appears. 

7 Select Yes to save the changes and exit, or No to exit the file without 
saving the changes. 


124 


(J 


22 Script Files 
22.3 Deleting a Script File 


To delete a script file, follow these steps: 

1 Select Utility from the main menu. 

2 Select Edit Script File from the Utility menu. 

3 Select Unattended Script or Attended Script. The Select Script File 
menu appears, listing script files in the directory that contains Tape 
Mate II software. If you selected Attended Script, the list displays only 
the attended script files. If you selected Unattended Script, it displays 
only unattended script files. 

4 Highlight the name of the script file you want to delete. To select a 
group of files, highlight each file name and press [F5] to mark it. To 
unmark a file, press [F5] again. 

5 Press [Del]. A prompt asks you to confirm that you want to delete the 
file. 

6 Select Yes to delete the file or files; otherwise, select No. 


22.4 Script Language Commands 


The Tape Mate II script language uses a number of commands; here is a 
brief summary: 


APPEND Append current session to existing sessions. 
BATCH Execute a DOS batch file within a Tape Mate IT 

script. 
BEFOREDATE Select files dated on or before a specified date. 
DRIVE Specify a source or target drive. 
EJECT Set the Eject Tape flag so the volume ejects at the 

end of the operation. 
END Terminate the operation. =~ 
EXCLUDE Exclude paths/files from operation. = 
INCLUDE Include paths/files from operation. 0 
INTERMEDIATE Back up only files modified since last backup. = 
MODE Select Backup, Restore, or Verify. = 
MOUNTWAIT = Specify a hardware “wait” time to account for oO 


robotic insertion of tapes on certain devices 


(Exabyte EXB-10). 


OPTIONS Specify run time options. 

OVERWRITE Overwrite the selected volume, rather than 
append the data. 

PATH Specify a source or target path. 

RDATE Specify a retention date for the session. 

REM Insert a remark or description of the script file. 

SESSION Select the number of the session to be restored or 
verified. 


125 


2 
\S) 
= 

my) 

e 


SC Shots User Guide 


SESTITLE Specify a session title. 
SINCEDATE Select files dated on or since a specified date. 
VOLTITLE Specify a volume title. 


The following sections present the command format and describe the 
commands. 


22.4.1 Command Format 


Type commands in uppercase letters, lowercase letters, or a combination of 
the two. For all commands except APPEND, END, INTERMEDIATE, 
and OVERWRITE, the command format is 


COMMAND = COMMAND SYNTAX 
For APPEND, END, INTERMEDIATE, and OVERWRITE, type only 


the command name, for example 


APPEND 


22.4.2 _Command Descriptions 


APPEND—Use APPEND to append the current session to existing 
sessions on the volume during a backup. Once the APPEND command 
appears in a script file, it applies to all remaining sessions. 


APPEND 
BATCH—Any standard DOS BATCH file may be specified and executed 


via this command. Since these commands are executed within a Tape 
Mate II software operation, you must consider memory requirements. 
Do not use such batch files to load a TSR or to execute applications 
accessing the backup drive. 


BATCH = C:\BATCH\RUN.BAT 
BEFOREDATE—Use this command to select files created or modified on 


or before a given date. The operation is performed on any file dated on 
or before the date specified. The date format is MM/DD/YY. In the 
following example, the operation is performed only on data created or 


modified on or before July 30, 1993. 
BEFOREDATE = 7/30/93 


DRIVE—Specify a source drive for backup and verify operations, or a 
target drive for restore operations. Each drive to be used in the 
operation must be listed on a separate line as a different DRIVE 
command. Section 22.5 contains additional instructions on using this 
command. 


126 


} 


todo) 7939 7 7 «¢ § FF TF 111 7 


22 Script Files 
DRIVE = D: 


EJECT—Use this command to eject the volume at the end of an 
operation. The volume is ejected only if the archive device supports 
ejection under software control. This command should appear only in 
the last session in the script file. 


EJECT = ENABLE 


END—This command terminates the operation. It is required at the end 
of every script file. 


EXCLUDE—Use EXCLUDE to select directories and files to be excluded 
from the operation. A script file can contain more than one EXCLUDE 
command. If this command is not included in the script file, no files 
are excluded. Use a separate EXCLUDE statement for each path 
(directory/file) to be excluded. Adding a , ¥ or a ,N dictates whether 
the contents of subdirectories are included (, ¥ to include subdirectory 
contents; , N to exclude them). 


EXCLUDE = \*.EXE, N or 
EXCLUDE = \*.COM, Y 


INCLUDE—Use INCLUDE to select directories and files to be included 
in the operation. A script file can contain more than one INCLUDE 
command. If this command is not included, all files (“*.*”) are 
included. Use a separate INCLUDE statement for each path 
(directory/file) to be included. Adding a , ¥ or a , N dictates whether 
the contents of subdirectories are included (, ¥ to include subdirectory 
contents; , N to exclude them). 


INCLUDE = \*.ASM, Yor 
INCLUDE =\*.DRV, N 


INTERMEDIATE—Use this command to perform an intermediate 
backup. Only files modified since the archive flag was reset are backed 
up. Including or excluding the command OPTION = A (resets the 
archive flag) determines whether the intermediate backup is a 
differential or an incremental operation (see Section 17.2). 


INTERMEDIATE 
MODE-—Specify one of the three modes: Backup, Restore, or Verify. This 


command is required at the beginning of every script file. 


MODE = BACKUP 


— 
° 
@ 
= 
5 
rT 
@ 


127 


g 
G 
= 
a 
e 


SC Shros User Guide 


MOUNTWAIT—This command specifies a hardware “wait” time for 
autochangers, such as the Exabyte EXB-10. Tape Mate II software 
does not support autochangers, but this command is maintained for 
upward compatibility. 


MOUNTWAIT = 200 


OPTIONS—This command specifies the run time options. The format is 


OPTIONS = A 


where the letter to the right of the equal sign represents the selected option. 


Enter the following letters to select options: 


Reset the DOS archive flag 

Delete file after backup 

Encrypt data 

Append this session to the existing session 
Restore the file only if the archive version has 
more recent date 

Preview mode 

Query overwrite. Do not overwrite existing files 
Restore “read-only” files 


Verify after backup 


Z2sHO Pp 


470 0 


To specify more than one option, type the letters together in any order. 


Use no spaces or commas between the letters. For example, the 


following command selects options to reset the DOS archive flag and 


encrypt the data. 
OPTIONS = EA 


OVERWRITE—Use this command to overwrite existing data on a 
volume. If you use this command in a script that places multiple 
sessions on a volume, place the OVERWRITE command in the first 
command set (see Command Sets, later in this chapter). (If you place 


the command in a subsequent command set, the sessions following the 


OVERWRITE command will overwrite the previous sessions.) The 


default procedure is to append data, so that any previously written data 


is preserved. 


OVERWRITE 


PATH—Specify the source path for backup and verify operations or the 


target path for restore operations. This command cannot be used 
globally; it affects only data on the drive specified by the DRIVE 
command listed previously in the script file. A separate PATH 


128 


$3999 9 9 39 9 ) 39 3 J 1 9 7 Y 


53 9 9 1 9 


i, 


22 Script Files 


command must be used for each drive. If the script file does not 
contain a PATH command, the root directory is assumed. 


PATH = \TMATE 


RDATE—Use RDATE to specify a retention date for the current (new) 
session. The format for the date is MM/DD/YY. Leading zeros aren’t 
necessary for single-digit months and days. 


RDATE = 1/1/94 


REM—Use this command to insert a brief remark. This command does 
not affect the execution of the script file. 


REM = Backup of Server 1 


SESSION—Use this command to specify the session number for restore 
and verify operations if other than the first session is to be used. 


SESSION = 2 


SESTITLE—Use this command to specify a session title. 
SESTITLE = FILESERVER 1 BACKUP 


SINCEDATE—Use this command to select files created or modified on 
or after a given date. The operation is performed on any file dated on 
or after the date specified. The date format is MM/DD/YY. In the 
following example, the operation is performed only on data created or 
modified on or after January 15, 1993. 


SINCEDATE = 1/15/93 


VOLTITLE—Use VOLTITLE to specify a volume title. 
VOLTITLE = FULL BACKUP #1, TAPE #1 


22.5 Script File Format 


This section describes the required command sequence for both the 
attended and unattended script files. The requirements and restrictions are 
different for the two types of script files. 


22.5.1 Attended Script Files 
An attended script file can have only INCLUDE and EXCLUDE 


commands, as illustrated in Figure 48. No other commands are needed, 
because the script is merely a substitute for entering path and file name 
specifications in the Inclusive and Exclusive File Selections dialog boxes 
(see Section 18.5). You must select and run an attended script file from 
within Tape Mate II software; see Section 18.5 or 19.3.4 for directions. 


— 
2 
@ 
= 
a) 
CT 
@ 


129 


9 
‘SG 
= 
8 
e 


SC Shrorc: User Guide 


oa See 
Tape Mate II Friday September 17, 1993 6:51 am 


INCLUDE=Nasm\ iasN\nsureN*.* 
EXCLUDE=Nasm\ ias\nsure\*.obj 
EXCLUDE=Nasm\ ias\nsureN*. arc 
EXCLUDE=Nasm\ ias\nsureN\* .ndx 
EXCLUDE=Nasam\ ias\nsure\*.hst 


Figure 48 Sample INCLUDE and EXCLUDE Commands 


22.5.2 Unattended Script Files 


The requirements for an unattended script file are more extensive because 
it must specify the parameters normally defined on the Backup, Restore, or 
Verify Parameters dialog box. In addition, the order in which the 
commands appear in the script file affects the operation. This section 
describes the required commands and format for unattended script files. 


For information on scheduling and running an unattended script file, see 
Chapter 21. 


Required Commands 
All unattended script files must contain the commands MODE, DRIVE, 
and END. A DRIVE command must also be entered for each drive to be 


used in the operation. Other commands may be used as needed. 


Command Sequence 


The required command sequence for an unattended script file is 


MODE 
‘ (At least one DRIVE command and any optional commands) 


Several commands that can apply globally, affecting all specified drives, can 
also apply to individual drives. Whether a command affects all drives or a 
specific drive is determined by the location of the command relative to the 
DRIVE command(s) in the script file. Commands that can be used 
globally or specifically are 


130 


22 Script Files 


INTERMEDIATE 
INCLUDE 
EXCLUDE 
OPTIONS 
SINCEDATE 
BEFOREDATE 


If any of these commands appear before the firsts DRIVE command, they 
affect all drives listed in the script file. Any that appear after one DRIVE 


command but before a second DRIVE command affect only the first drive. 


For example, 


INTERMEDIATE This command applies to all drives. 
DRIVE = C 

EXCLUDE = \*.EXE This command applies to drive C. 
DRIVE = D | 

OPTIONS = P This command applies to drive D. 


The PATH command can be used only after a DRIVE command. Ifa 
PATH command doesn’t follow a DRIVE command, the root directory is 
used as the path for that drive. 


Other commands can appear anywhere in the script file after the MODE 
command and before the END command. These commands are 


APPEND 
SESSION 
SESTITLE 
VOLTITLE 
RDATE 
EJECT 


The REM command is the only command that can appear before the 
MODE command. 


Command Sets 


A command set is a list of commands starting with the MODE command 
and ending with the END command. A script file may contain one or 
more command sets. The following example illustrates a command set for 
a backup operation: 


MODE = BACKUP Specifies a backup operation. — 

INTERMEDIATE Selects files modified since the archive flag 
was reset. 

OPTIONS = AE Resets archive flags after backup, and encrypts 


data on the archive volume. 
INCLUDE = \*.* Includes all files on all drives. 
DRIVE = C: Selects drive C for backup. 


131 


— 
T 
° 
<= 
9) 
@ 


SC Shots: User Guide 


EXCLUDE = \*.EXE = Excludes \.EXE files on drive C from backup. 


DRIVE= D: Selects drive D for backup. 
PATH = \VENTURA Starts the backup in the \WENTURA 
directory 


INCLUDE \*.*,N = Overrides the global INCLUDE command 


above, choosing to not back up subdirectories 


of D:\WENTURA. 
DRIVE = E: Selects drive E for backup. 
INCLUDE = \*.EXE Overrides the global INCLUDE command; 


on drive E, only \.EXE files will be backed up. 


END Terminates the script file. 
22.6 Validating a Script File 


You can verify that an unattended script file performs correctly by 
executing it at the DOS command line and observing the operation. To 
execute the script file, type TMATE followed by the name of the script file; 
you needn’t include the file extension. To execute a file named 
BACKUP.NSF, for example, type TMATE BACKUP and press [Enter]. 


You can decrease the time required for the operation by temporarily 
adding the Preview run time option to the script file. This lets you verify 
both syntax and workstation configurations without actually writing to the 
archive volume or the destination drive. To add the Preview option, 
modify the script file to include the following line: 


OPTIONS = P 


ES DO NOT FORGET to remove the OPTIONS = P line from the script 


g 
G 
= 
S 
e 


file after you validate the file. If this line remains in the file, the unattended 
operation will write the data only to the computer screen, and not to the 
volume or destination drive. 


132 


q 


J 


jo) J 


Jo)o) 


1) J 


17 


my 


23 Database Resources 


The Tape Mate II database lets you keep track of the volumes and 
sessions that are used by or created with Tape Mate II software. Volume 
and session information is stored in the database only if the Volume/ 


Session Database option in the Global Configuration Parameters dialog 
box is enabled (see Section 25.2). Enabled is the default setting. 


Use the Database Resources utility to view information on any volume or 
session defined in the database. The information in this database is 
cross-referenced so that a volume can be selected and a list of the associated 
sessions displayed. If a session is selected, then the volume or volumes 
associated with that session can be displayed. You can also use Database 
Resources to add new volumes and to delete volume and session entries 
from the database. 


To use Database Resources, select Utility from the main menu, then select 
Database Resources to display the Database Selection menu, shown in 


Figure 49. The menu has the following options: 
i 


Tape Mate II Friday September 17, 1993 6:54 am 


Utility Configuration 


ee 


Database Resources 
Initialize Media 
Retension Media 
i} |Eject Media 
Session Database Maintenance i} |Print Log 
Add New Volume || |Unattended Parameters 
Purge Database an) |Edit Script File 
General Information 


aot 
D 
Q 
= 
Oo 
@ 


Figure 49 Database Selection Menu 


¢ Volume Database Maintenance—View volume information. De- 
lete volumes and sessions from the database. Change the entry for 
the volume storage location. 

e Session Database Maintenance—View session information. 

e Add New Volume—Add a volume to the database. 

¢ Purge Database—Delete all information from the database. 


Each of these options is described in the following sections. 


133 


2 
G 
= 
S 
© 


SCShrors: User Guide 


23.1 Volume Database Maintenance 


When you select Volume Database Maintenance from the Database 
Selection menu, the Volume Database Information dialog box appears. It 
lists all volumes defined in the database. From this dialog box, you can 
view summary information on all defined volumes; view detailed 
information on a volume; delete a volume; and change the entry for the 
volume storage location. 


To view summary information for all volumes, press [F9]. A Volume 
Summary Report screen appears, as shown in Figure 50. Press [Esc] to 
display any additional records that did not fit on the screen and to exit the 
screen. 


Tape Mate II Friday September 17, 1993 12:19 pm 


Backup Restore Verify Utility Configuration Quit 


| Volume Summary Report i 


Esc=Exit 


Figure 50 Volume Summary Report 


To view details on a volume, highlight the volume title in the Volume 
Database Information dialog box and press [Enter]. The Volume Detail 
Information dialog box appears (see Figure 51), displaying the following 


information about the selected volume. 


¢ Storage Location—indicates where the volume is stored when not 
in use. 

e Creation Date—indicates the date a volume header was written on 
the volume. 

¢ Media Count—indicates the number of volumes (media) used in 
the backup operation. 

e Session Count—indicates the number of sessions on the volume. 

° Device Type—indicates the type or class of device used for the 
backup operation. 

¢ Data Quantity (Bytes)—indicates the total amount of data stored 
on the volume. 


134 


23 Database Resources 


Sma In ye SES eee a | 
| Tape Mate II Friday September 17, 1993 12:19 pm 


= Backup Restore Verify Utility Conf iguration | 
i PR APSR: i t if Rane i ; # Ras i H i ig) ¢ RHR ARR RAAB a 
t i ; { iia 


Volume Title: Backup — Tape 1 
Storage Location: 
| Creation Date: Thursday Sept. 16, 1993 
i) Media Count: 1 
Session Count: 1 
Device Type: DDS DAT 4mm Tape Device 
Data Quantity (Bytes): 11,875,804 


Figure 51 Volume Detail Information Dialog Box 


Storage Location is the only field in this dialog box that can be changed. 
To change the entry in this field, type a new storage location, and then 
press [F3] to update the field with the new information. 


While in the dialog box, you can press [F4] to list the sessions in the 
volume. Press [F9] to print the information to a printer. 


You can also use the Volume Detail Information dialog box to delete the 
volume. To do so, press [F8]. The Delete Database Records menu appears. 
Select Delete Session Records Only or Delete Volume and Session 
Records. When prompted to confirm your selection, select Yes to delete 
the records or No to cancel the deletion. If only the session records are 
deleted from the database, the number in the Session Count field is reset to 
zero. If both the volume and session records are deleted from the database, 
the volume title is removed from the list of volume names in the Volume 
Database Information dialog box. 


23.2 Session Database Maintenance 


— 
° 
@ 
= 
a) 
rT 
@ 


To view session information, select Session Database Maintenance from 
the Database Selection menu. The Session Database Information dialog 
box appears. Using this dialog box is similar to using the Volume Database 
Information dialog box, described in the previous section. See that section 
for details on viewing information. The option to delete volumes and 
sessions is not available in the Session Database Information dialog box; 
you must use the Volume Database Information dialog box. 


135 


g 
G 
= 
8 
2 


SC Shrotc: User Guide 


23.3 Adding a New Volume 


The Add New Volume option lets you add volumes that were created at 
other workstations or when the database was disabled. Follow these 
instructions to add a volume to the database: 

1 Select Add New Volume from the Database Selection menu. You are 
prompted to mount the archive volume. 

2 Insert the volume in the archive device and press [F2]. The Volume 
Detail Information dialog box appears, displaying information about 
the volume. You are prompted to add the volume to the database. 

3 Select Yes to add the volume to the database; otherwise, select No. If 
you select Yes, you are prompted to enter a storage location. 

4 Type the storage location if desired, and press [Enter]. A message 
prompts you to add the sessions on the current volume to the database. 

5 Select Yes to add the sessions or No to add only the volume name. 
Several messages appear, including a final message that the volume has 
been added. 


6 Press [Esc] to return to the Database Selection menu. 


23.4 Purging the Database 


Use the Purge Database option to delete all session and volume entries 
from the database. When you select Purge Database from the Database 
Selection menu, you are prompted to confirm that you want to delete all 
database records. Select Yes to clear the database of all volume and session 
records. Select No to exit without deleting any records. 


23.5 Exiting the Menu 


Select Exit from the Database Selection menu to close the menu and 
return to the Utility menu. To return to the main menu, select Exit from 


the Utility menu. 


136 


J 


|e ee ee 


Se ee ee ee ee | 


j 


J 


24 Utility Menu 


This chapter describes the Utility menu, shown in Figure 52. The menu 
contains the following options: 


¢ Database Resources—View and manage the contents of the 
database. 

¢ Initialize Media—Erase or format tapes. 

¢ Retension Media—Retension a tape. Retensioning winds a tape 
from one spool in the tape cartridge to the other and back again. 

° Eject Media—Eject a tape cartridge from the tape drive (available 
only if the drive supports ejection under software control). 

¢ Print Log—Print the log history file on screen or to a printer. 

e Unattended Parameters—Schedule an unattended operation. 

¢ Edit Script File—Create, edit, and delete attended and unattended 
script files. 

e General Information—View a screen of general information about 


your copy of Tape Mate II software. 


This chapter describes all options except Database Resources, Unattended 
Parameters, and Edit Script File, which are described in Chapters 23, 21, 
and 22, respectively. 


Friday September 17, 1993 6:52 am 


Initialize Media 
Retension Media 
Eject Media 

Print Log 

Unattended Parameters 
Edit Script File 
General Information 


— 
D 
Q 
= 
O 
cr 
Q 


Figure 52 Utility Menu 


24.1 Initializing Media 


You can use the Initialize Media utility to erase or format tapes. To use the 
utility, follow these steps: 
1 Select Utility from the main menu. 


137 


2 
O 
= 
Q 
: 


QC Shroric! User Guide 


2 


3 


Select Initialize Media from the Utility menu. You are prompted to 
mount the archive volume. 

Insert the tape in the tape drive, and press [F2] to continue. A message 
prompts you to verify that you want to continue. (If the tape has never 
been used with Tape Mate II software, this message doesn’t appear; 
skip to step 7 to continue). 

Select Yes to continue or No to stop. 

If initialization will violate a retention date specified for any session on 
the mounted volume, a second message notes this and asks whether you 
want to continue. Select Yes to continue or No to stop. 

If you selected Yes, a Keep Current Volume Header prompt appears. 
(If the database is disabled, as discussed in Section 25.2, this message 
doesn’t appear; skip to step 7 to continue.) The first time Tape Mate 
II software used the tape, a valid volume title was assigned. Select Yes 
to keep the assigned volume header, or No to change it. 

A menu appears with the following options: Format Media and Erase 
Media. Select either Format Media or Erase Media, as required. The 
tape is then initialized. 


ZS Formatting is the shorter procedure of the two options. Formatting 


rewrites the header information and functionally erases the tape. 
Normally, this is all that is required. Erasing physically erases the tape 
from beginning to end; this may take several hours if the tape drive is a 
DAT or 8-mm drive. 


If in step 6 you elected to change the assigned volume header, the 
Volume Information dialog box appears. In the Volume Title field, 
which is required, type a new volume title. In the Storage Location 
field, which is optional, you can type the location where the tape will 
be stored when not in use. Press [F2] to save this information. When 
prompted whether to add the volume information to the database, 
select Yes to do so; otherwise, select No. 


A message informs you when initialization is complete. Press [Esc] to 
remove the message and return to the Utility menu. 


24.2 Retensioning Media 


Retensioning winds the tape from one spool in the tape cartridge to the 
other and back again. Manufacturers of tape cartridges and tape drives 
publish the recommended frequency for retensioning tape cartridges. 
Generally, if a tape cartridge has not been used in over a month, it should 
be retensioned before use. Follow these steps to retension a tape: 


1 


Select Utility from the main menu. 


2 Select Retension Media from the Utility menu. You are prompted to 


mount the archive media. 


138 


Yo! 1 9°23 7 4 


7 


J 


Foy } 1979 7 J 


§$:) 43 7 


: 24 Utility Menu 


3 Insert the tape in the tape drive, and press [F2] to continue or [Esc] to 
abort the operation. 


A message informs you when retensioning is finished. Press [Esc] to clear 
the message and return to the Utility menu. 


24.3 Ejecting Media 


You can use this utility to eject a tape if the tape drive supports ejection via 
software control. Select Eject Media from the Utility menu. A message 
informs you when the tape is ejected. Press [Esc] to clear the message and 
return to the Utility menu. 


24.4 Printing a Log 


Use Print Log to print or review any log history file generated by Tape 
Mate II software. Log history files are generated only if the Log History 
option is enabled in the Global Configuration Parameters dialog box (see 
Section 25.2). They are automatically stored in the Tape Mate II directory. 


Log history files list operations performed, initialization parameters, files 
involved, and errors that occurred during the operation. All log history files 
are assigned an .HST file name extension. The name of a log history file is 
the date the operation was executed (YYMMDD); multiple executions on 
the same day are made unique with a letter appended to the file name. 


24.4.1 Viewing and Printing a Log History File 


To view or print a log history file: 

1 Select Print Log on the Utility menu. The Report List menu appears, 
as shown in Figure 53. This menu lists all log history files in the 
directory that contains Tape Mate II software. 

2 Select the name of the log history file you want to view or print. A 
prompt asks whether you want to print to a printer. 

3 Select No to review the contents of the file on screen. Select Yes to 
print to a printer connected to LPT 1. Verify that the printer has power, 
is on-line, and has paper. Figure 54 illustrates a log history file. 


24.4.2 Deleting a Log History File 


To delete a log history file: 

1 Select Print Log on the Utility menu. The Report List menu appears, 
listing the log history files. 

2 Highlight the name of the log history file you want to delete. To mark 
a group of files for deletion, highlight each file and press [F5]. To 
unmark a file, highlight it and press [F5] again. 

3 Press [Del]. 

4 When prompted to confirm that you want to delete the file, select Yes 
to delete the file or No to cancel the deletion. 


_ 
> 
Qa 
= 
O 
cr 
a 


139 


2 
G 
= 
a 
e 


SC Shore: User Guide 


Tape Mate II Friday September 17, 1993 6:53 am 


Restore Verify Utility Configuration 
LEC ert 
Baan Ina | = Database Resources 
cigtait! Retension Media 
es Eject Media 
936914AB. ia Print Log 


938914AC. eee Unattended Parameters|/(i) || 
938914AD. : Edit Script File 
938914AE. General Information 


i ce i ou HES i 
f group delete) 


Figure 53 Report List Menu 


Log history files can also be deleted using the DOS Delete command. See 


your DOS reference manual for details. 


F- SESS Se ee a : 
Tape Mate II Friday September 17, 1993 6:53 am 


Backup Restore Verify Utility Configuration Quit | 


| Log Display 


Tape Mate II History File DATE/TIME: 89/14/93 14:42:51 | 
Application Version: Vi1.28 (86/28/93) 
MODE: Backup 
Backup I/0 Error: -21 - Device Unavailable | 
* The Backup was Abnormally Terminated * 
Tape Mate II History File DATE/TIME: 89714/93 14:43:38 

| 


i4=NextLine t=PruLine PqDn=NextPqg PqUp=PruPy HOME=istPqg END=LastPy Esc=Exit 


Figure 54 Log History File 


24.5 Obtaining General Information 


Select General Information on the Utility menu to display the Tape Mate 
II software version number, options, serial number, the company name, 
user name, copy number, and Tape Mate II software developers. 


24.6 Exiting the Utility Menu 


To exit the Utility menu, select Exit on the menu or press [Esc]. 


140 


25 Configuration Menu 


Use the Configuration menu to set the following: 


¢ Local Configuration Parameters—defines the type of archive de- 
vice used in operations. 

¢ Global Configuration Parameters—determines whether you save 
log history files, operate in monochrome, enable the Volume/Ses- 
sion database, and eject the volume automatically at the end of a job. 


25.1 Local Configuration Parameters 


The local configuration parameters define the local hardware device used 
in the archive operations. The initial configuration is set the first time you 
use Tape Mate II software (see Chapter 16). If you later need to 
reconfigure Tape Mate II software—for example, if you switch to a 
different tape format—follow these steps: 

1 Select Configuration from the main menu. The Configuration menu 


appears, as shown in Figure 55. 


Tape Mate II Thursday September 16, 1993 7:52 am 


Global Configuration Parameters 
Path Configuration 


—_ 
2 
0) 
= 
a) 
cr 
@ 


Figure 55 Configuration Menu 


2 Select Local Configuration Parameters. The Local Backup Device 
Selection dialog box appears. 

3 Press [Enter]. The Device Type Selection menu appears, listing 
supported devices. An arrow at the left of the menu indicates the list 
extends beyond the menu box. To scroll through the list, use the arrow 
keys or press [PgUp] and [PgDn]. 

4 Highlight the correct device, and press [Enter]. 


141 


2 
G 
= 
© 
e 


WCShrotcs User Guide 


5 


If Tape Mate II software needs additional information for your device, 
a Device Configuration dialog box appears. The dialog box contains 
one or more of the following fields. 


Compression—The default setting for this field is Default. With this 
setting, Tape Mate II software will use the media as it has 
previously been used: If the media was used with compression 
enabled, then compression will be used; if the media was used with 
compression disabled, then compression will not be used. To 
change this setting, select the Compression field; then select 
Disabled to disable compression, or Enable to enable compression. 


Target Device SCSI ID—The default setting for this field is Auto. 
With this setting, the driver will use the first device of this product 
type that it finds on the SCSI bus. To change the setting, press 
[Enter] to display the SCSI Bus ID menu; then select from the list 
of possible SCSI identification numbers, 0-7. 


Tape Speed—Select this field to list the supported tape speeds for the 


selected device; then select the appropriate tape speed. 


Tape Density—Select this field to list the options Default, Enabled, 
and Disabled, and select an option. 

Press [F2]. The Adapter Type Selection dialog box appears, with the 

single option: ASPI for DOS Driver. 

Press [Enter]. Another Device Configuration dialog box appears, 

displaying the Card Number field. 

In the Card Number field, the default is Card 0. If you have multiple 

adapters running under ASPI, you may need to select the appropriate 

card number for the device. First try card 0. If Tape Mate II software 

doesn’t recognize the device, try another card number up to 4. To 

select the card number, select the Adapter field, and then select the card 

number. 

Press [F2]. The names of the selected device and driver (if applicable) 

appear in a box at the lower right of the screen, as shown in Figure 56. 


10 Press [F2] to save the configuration parameters. A Save Changes 


prompt appears. 


11 Select Yes to save the changes, or No to abandon them. Changes are 


saved in the configuration file. 


25.2 Global Configuration Parameters 


The global configuration parameters let you determine whether to save log 
history files, operate in monochrome, enable the Volume/Session database, 
and eject the volume automatically at the end of a job. To set the 
parameters, follow these steps: 


142 


13)? 1? 7~=!1 


| re re es re ee rs Ps Os se | 


J 


25 Configuration Menu 


Tape Mate II Thursday Septer September 16, “4993 _ 7:53 am 


j Backup — Restore _ Verify ci I en i, i _ Configuration Quit 


"aia Sseckd. ‘Masini Benltn-Salantine: 


Current Backup Device: 


YD-7181 Series Streaming Cassette 
YED7181.DRYV, Version 2.64 

ASPI for DOS Driver 
ASPI.DRU, Version 2.86 


Figure 56 Currently Selected Drivers Dialog Box 


1 Select Configuration from the main menu. The Configuration menu 
appears. 
2 Select Global Configuration Parameters. The Global Configuration 


Parameters a box appears, as shown in Figure 57. 


Thursday Saitenber 16, 1993 8: 14 an 


Restore Verify Utility Configuration 


Global Configuration Parameters | 
: Errors Only | 
Backup Run Time Options: Default Parameters 
Restore Run Time Options: Default Parameters 
Eject On End Of Job: Disabled 
Volume/Session Database: 
Backup Open Files: NO 
Force Monochrome Display: NO 


4 
D 
Q 
Fi-Help F2=Save F7=Exit Tab=Next Field 2 
——4 
— 


Figure 57 Global Configuration Parameters Dialog Box 


3 Use the fields in the dialog box to set the parameters you want. A 
description of each field immediately follows these steps. 
4 Press [F2] to save the changes. A Save Changes prompt appears. 


5 Select Yes to save the changes, or No to abandon them. All parameters 
in this dialog box are permanently saved in a configuration file. 


143 


SC Shots: User Guide 


Log History—Tape Mate II software creates a log file for each operation 
(backup, restore, or verify). Select this field to specify the type of 


information that will be stored in the log file. The options are 


¢ None—Store no information. 

¢ Errors Only—Store only the header, session information, operation 
type (e.g., backup or restore), and error information. 

¢ Full—Store all information for all files. This can result in extremely 
large files. 


The default setting is Errors Only. To change the setting, select the Log 
History field, and then select an option. To read, print, or delete the 
log files, use the Print Log option on the Utility menu. See Chapter 24 
for details. 


Backup Run Time Options—Use this field to select global backup run 
time options. The options you select automatically appear as the 
defaults in the Backup Parameters dialog box. The run time options 
and their function are the same as those described in Section 18.3. 


Restore Run Time Options—Use this field to select global restore run 
time options. The options you select automatically appear as the 
defaults in the Restore Parameters dialog box. The run time options 
and their function are the same as those described in Section 19.3.3. 


Eject on End of Job—For devices that support software eject control, 
enabling this parameter instructs Tape Mate II software to eject the 
volume when an operation is finished. The default setting is Enabled. 
To disable this feature, select the Eject on End of Job field, and then 
select Disable. 


Volume/Session Database—The Tape Mate II database stores 
information about the volumes that have been used by Tape Mate II 
software. This database also records session information. Volume 
information stored in the database includes the volume title, storage 
location, creation date, media count, session count, and device type. 
Session information includes the title, session number, source path, 
media count, creation date, retention date, session size, and whether a 
password is required. 


g 
G 
= 
g 
o 


The default setting for this field is Enabled, so that volume and session 
information is stored in the database. If the database is disabled, the 
Database Resources utility on the Utility menu cannot be used, since 
the database contains no information. For information on using the 
database, see Chapter 23. 


Backup Open Files—To obtain a completely valid backup copy of a file, 
no other application may have the file open during the backup 
operation. However, some files required to support mission-critical 


144 


ss se ee 


1 


| 


Se re ee 


[ 


25 Configuration Menu 


applications may be active almost 24 hours a day. To provide some 
facility for backing up such files, select the Backup Open Files field, 
and then select Yes. This allows Tape Mate II software to open these 
files (on retry) in a read/share mode and attempt a complete backup. If 
records are not locked, a valid copy of the file can be obtained. If 
records are locked, Tape Mate II software “reads around” these locked 
file regions, and replaces the corresponding record locations with 
binary zeros. The files in such cases are compromised, but some 
databases supply utilities to rebuild such corrupted files. The default 
setting for this option is No. 


Force Monochrome Display—Tape Mate II software was designed for 
color monitors, and some monochrome monitors attempt to display 
the screens in color. This results in a distorted screen image. To force 
Tape Mate II software to operate in a monochrome mode, select the 
Force Monochrome Display field, and then select Yes. The default 
setting is No. 


25.3 Exiting the Configuration Menu 


Select Exit from the Configuration menu to close the menu and return to 
the main menu. 


145 


+ 
gy 
= 
(2) 
@ 


Fr kEEkEeEeE FEEL 


! User Guide 


L 


EF EL 


rorEL 


if £EkEaie¢et 


I] 2}0w edb] 


L 


i 


146 


26 Tape Mate II Upgrade Options 


Since you have already received Trantor’s Tape Mate II software, you 
have the option of upgrading this valuable standalone archiving application 
to a network archiving version. Trantor has arranged with FortuNet 
(developers of Tape Mate II software) to provide these archiving 
products to you at a discount. 


Nsure Overview 


FortuNet’s Nsure products provide cost effective solutions to safeguarding 
your valuable data with extensive features today and an upgrade path for 
tomorrow. Nsure products vary from network products for DOS 
workstations to Novell NLM (NetWare Loadable Module) products 


with autochanger support. 


Nsure is distributed across the network as separate application modules: 
Nsure Manager and Nsure Client. This architecture provides the flexibility 
to back up and restore virtually any device on a network. The Nsure 
Manager supports the LAN Administrator in performing necessary 
operations from a single station within the network. The Nsure Client 
provides support for backing up client stations. 


As a distributed application, Nsure is the most advanced data management 
application available today for networked storage resources. Nsure is fully 
independent of operating systems, network operating systems, 
communication protocols and storage devices. 


Nsure Features 


Nsure features wildcard selection, empty subdirectory selection, before and 
after data ranges, incremental and differential modes, inclusive and 
exclusive selection, and restore directory (tree) selection. 


Nsure’s other features include open file retry, history log, unattended 
operation scheduling, script language, data encryption, volume/session 
database, client workstation backup/restore, Novell NetWare 2.2 and 3.1x 
support, Apple Macintosh backup/restore on NetWare servers, multi-level 
password security, Quick File Access (QFA), multiple drive support 
(“node” level backup/restore), autochanger support, dynamic server 
login/logout, and NetWare Trustee/Bindery support. 


—{ 
D 
@ 
<= 
a) 
CT 
@ 


Nsure works with most popular network operating systems including 
Novell’s NetWare/286/386, NetWare Lite, Microsoft's Lan Manager, 
Artisoft’s Lantastic, and many others. Nsure requires either MS/PC-DOS 
(3.1 or greater) or DR-DOS (5.0 or greater) and 512 KB of available 


147 


2 
G 
= 
S 
e 


SC Shorts: User Guide 


memory from the network manager and 44 KB from the client. Client 
access protocols include NetBIOS and NetWare IPX. Nsure products 


support the following archive devices: 


¢ Floppy Disk-DOS Addressable Devices (5Y4 & 32-inch, etc.) 

¢ \4-inch Tape Devices (QIC-DC600), QIC-02 (Archive, Irwin, 
Mountain, Tandberg, Wangtek), SCSI (Archive, Tandberg, 
Wangtek, Sankyo). | 

° Cassette Tape Devices Teac, Y-E Data. 

¢ Digital Audio Tape (4-mm & 8-mm) including Archive, ARDAT, 
Exabyte, JVC, Wangtek, WangDAT, Hewlett-Pachard, Sony. 

° Other Media-Addressable Devices including Removable Hard Disks, 
Optical-WORM Drives, Optical-Multifunction Devices. 

° Autochangers including ADIC 1200 and 1200C; Exabyte EXB-10 
and EXB-10i; Soltronics PROTEC 50/55 and 10/15; Colorado 
Technical Designs COL/8L, COL/8SL and COL/4L; Spectra Logic 
BTL-8000; WangDAT LD-4; and others. 


Nsure Versions 
The following paragraphs detail Nsure upgrade versions: 
OneNet—a network backup and restore product for multiple servers. 


AllNet—a network backup and restore product for unlimited number of 
servers or DOS workstations. 


NLM/AllNet—an NLM network backup and restore product for 
unlimited number of servers or DOS workstations, with full selection 
and scheduling capabilities. It complements the above DOS-based 
products and provides higher performance and security of a 
server-based solution. 


OS/2 Client—allows your AllNet or NLM/AllNet to support backup of 
OS/2 “client” stations on multiple OS platforms. Client modules are 
supplied for OS/2 V1.1, 1.3, 8&¢ 2.0. OS/2 Client runs in the 


background and permits seamless operations from a master workstation. 


NLM AutoChanger (Server-Based)— includes the NLM/AllNet with 
support for 4-mm & 8-mm autochangers for the highest capacity 
backup needs with capacities ranging from 8 GB to over 300 GB. 


To insure your discount, order your FortuNet Nsure Upgrade from - 
Trantor. Simply tear out the coupon on the following page and send it to 
Trantor or call Trantor direct at 1-800-TRANTOR. Additional 
technical information and support for these products is available from 
FortuNet at 1-800-959-0718 or 1-801-467-6887 — this phone number is 
for upgrade inquiries only. Technical support for SCSIworks! software 
is available only from Trantor Systems Limited (see Chapter 12). 


148 


117377373919 3 27~*29 


J 


I 


1r1d)di1id1é! 


13d 


roto 


‘AFortuNet Upgrade 


To earn 30% off any version of Nsure, simply tear out this page and send to Trantor. 


30% OFF 
Any Nsure Version 


Nsure Version Description Model # ListPrice Your Price 


OneNet Network backup/restore for NS-WS-ON $175 $122.50 
a single server 

AllNet Network backup/restore NS-WS-AN $895 $626.50 
for unlimited number of 
servers/DOS workstations 


NLM/AliNet Novell’s 3.x NLM network NS-NLM-AN $995 $696.50 
backup/restore NS-NLM-AN 
for unlimited number of 
servers/DOS workstations 


OS/2 Client OS/2 Client support for NSC-OS2 $195 $136.50 
workstation & server-based 
solutions 
NLM AutoChanger Novell’s 3.x NLM/AliINet with NS-NLM-AC $1,995 $1396.50 
(Server-Based) support for 4-mm & 8-mm 


autochangers 
Name 
Company. 
Address 
City, State ZIP/Postal Code 
Country Daytime Phone — 
Yes! I’m purchasing ___copy(ies) of $ ~ 
___copy(ies) of $ @ 
___copy(ies)of__..= = = £§ = 
USA shipping charge: $3.00 each for ground shipping $ 5" 
$10 each for 2-day shipping $ or 
$15 each for overnight shipping $ a 
(other countries, call Trantor for shipping rates) Total §$ — 
California residents: include 814% sales tax $ 
Total in U.S. funds $ 
Or, charge my Q Visa QO Mastercard: 
Acct# Expires 
Name on Card: Signature 
SEND TO: Trantor Systems Limited 


PO Box 9050, Dept. 380 

San Fernando, CA 91341-9050 
OR CALL: 1-800-TRANTOR 

1-818-837-7245 Fax 


Note: only original coupons will be accepted; no photocopies please. 
This discount offer is valid only for products purchased directly from Trantor. 


This offer expires Dec. 31, 1994. 
Prices and specifications subject to change without notice. 


F £E EL £€ EEF GF EE Et EL EF FE FE EF EF EE Et EL 


! User Guide 


150 


]] [ow ede] 


Appendices 


> 
=| 
ao 
oO 
— 
=n 
oO 
4°) 
Ww 


152 


ssoipuoddy 


j 


j 


oe oe 


A System Requirements 


Requirements 


IBM or compatible AT, PS/2, or similar computer. 


MS-DOS or PC-DOS 3.1 or above. DOS 3.3 or above is required 


to format and use partitions larger than 32 MB. 


A 100% IBM-compatible BIOS. Operation with some incompatible 


BIOSs may be possible but is not guaranteed. 
At least 640 KB of system memory. 


Additional Magic Lantern Software Requirements 


Any computer capable of running MS-Windows 3.x. 


¢ RAM—recommended 8 MB. The amount you have determines at 
what resolution you are able to display images, and how many image 


windows you are able to have open at once. 


CD-ROM player and driver supporting Photo CD—f the drive is 


not multisession-capable, you can to access only those images stored 


in the first session. 

Photo CD(s). 

Monitor and Video Card—recommended at least a Super VGA 
monitor at 256 colors. The higher resolution and the more colors 
your system supports, the more options you have for viewing 
images. 

Microsoft Windows 3.x 

MSCDEX (Microsoft CD-ROM Extensions). 


Additional Music Box Software Requirements 


Any CD-ROM drive which supports the MSCDEX CD-ROM 
extensions to DOS and which has audio-play capabilities. 
MSCDEX, version 2.1 or above, and a CD-ROM software driver 
which implements the appropriate audio-mode commands. These 


are included with SCSIworks! software. 


Windows version 3.0 or later for the Windows version of Music Box 


software. 


Additional Tape Mate II Software Requirements 
e A logical or local hard disk with at least 1.5 MB of free disk space. 
e A local hard disk, tape drive, or other supported archive device. 
Optional Requirements 
e A mouse compatible with the Microsoft Mouse Interface. 
e A dot matrix, daisy wheel, or laser printer to use Tape Mate II 


report feature. 


153 


7 
Y 
~ 
ae) 
= 
QO 
a 
< 


QC Shots User Guide 


Memory Usage 


Drivers 
e The ASPI manager, MAxxx.SYS, requires about 7 KB of system 
memory once loaded. TSCSI.SYS uses about 11 KB of system 
memory. In addition, at least 512 bytes of buffer space is required. 
TSLCDR.SYS uses about 10 KB of system memory. TSJII.SYS uses 
2.7 KB of system memory. In most cases, all Trantor drivers should 
be able to be “loaded high” on 386 and 386SX computers using 
memory managers such as QEMM?® from Quarterdeck and 
386Max® from Qualitas. 
DOS Extensions 
¢ MSCDEX typically requires about 20 KB of system memory, 
depending on how many buffers are allocated. It is also possible for 
MSCDEX to be “loaded high.” 


Music Box Software 
¢ Music Box software needs about 128 KB of system memory to run in 
non-resident graphical mode. The memory-resident option requires 
about 18 KB of memory when loaded. 


Magic Lantern Software 

¢ Your PC has three types of memory: conventional, extended, and 
virtual memory. Conventional memory is the first 1 MB of all the 
RAM you have installed in your computer. Of this 1 MB, 640 KB is 
used as an area in which programs are started. You never have the 
entire 640 KB free since some number of device drivers and TSRs 
are always present. It is important, however, that you fine-tune your 
system in order to have as close to 640 KB free as possible, or Magic 
Lantern software may not even start. 

¢ Windows uses extended memory to move large amounts of data. 
Windows also uses virtual memory, which is a swap file that is 
usually installed when you install Windows. The resolution and 
speed at which you can load images depends on the combined 
amount of extended and virtual memory. The greater the amount of 
memory, the better Magic Lantern software runs. If you have less 
than 8 MB of memory total, Magic Lantern software cannot perform 
at its best, and it may not be able to load high-resolution images. 


154 


q 


Jo] 


J J 


jyo}o3d 4) 


4] 


¥39 39 7 3 


4] 


J 


J 


B_ Introduction to ASPI 


What Is ASPI? 


ASPI (Advanced SCSI Programming Interface) is a software interface 
standard originally proposed by Adaptec (Milpitas, CA). ASPI documents 
became publicly available when Adaptec presented them to the SCSI CAM 
Committee (SCSI Common Access Method Committee) as a model for a 
public interface standard. Trantor SCSI host adapters support ASPI. 


The idea behind ASPI is to create a “black box” software interface—one 
which allows programmers to create software without having to know 
anything about the details of the SCSI interface hardware used in your 
computer system. With ASPI, it’s possible to write programs that can be 
used with any SCSI-based device used on a computer system that supports 
ASPI. While things are not always 100% perfect in all cases, ASPI greatly 
reduces potential compatibility problems for you, the user. And, of course, 
ASP] also reduces the need for detailed technical support by us. For both 


reasons, Trantor Systems fully endorses and supports widespread use of the 


ASPI standard. 


How Does ASPI Work? 


Essentially, there are two parts to an ASPI implementation, the ASPI 
“manager,” a device driver supplied by the hardware manufacturer, and the 
ASPI software application. Applications range from the ASPI-compatible 
CD-ROM and hard disk drivers supplied by Trantor to our Tape Mate II 
tape backup, scanner control applications from other companies or any 


other type of software designed to work with SCSI devices. 


It’s important to note that without an ASPI manager, ASPI compatibility 
is not possible. It’s the manager that creates the standard ASPI-compa- 
tibility layer between the SCSI host adapter hardware and the ASPI- 
compatible application. The manager is very hardware-specific, and is 
almost always supplied by the manufacturer of your SCSI host adapter. 
Trantor has supplied an ASPI manager in your SCSIworks! package for 
use with Trantor SCSI host adapters; you can identify it by its filename of 
MAxxx.SYS. During the software installation process, our manager and the 
appropriate CD-ROM or hard disk drivers are copied to your computer by 
the INSTALL program and are loaded through your CONFIG.SYS file 
during bootup. 

Referring to Figure 58, the ASPI CD-ROM and hard disk drivers actually 
work through the ASPI manager to perform their functions. Also, DOS 


applications which access your SCSI devices work through both the drivers 
and the manager. ASPI applications usually access the manager directly. 


> 
ime) 
igo} 
O 
= 
oe 
a 
oO 
7 


155 


“A 
v 
= 
ne’ 
& 
D 
a 
< 


SCShotcUser Guide 
From the standpoint of your } BOS Application — 
ASPI-compatible software, all ani a 


SCSI host adapters and devices 
connected to your system work the 
same way. The secret is the ASPI 
manager; it translates ASPI 
commands to those commands 
necessary for the specific SCSI 


adapter for which it was created. 


SCSI software, interface and device 
compatibility has traditionally been 
a source of concern and confusion 
for many users. ASPI compatibility 
goes a long way toward alleviating 
these problems and as a result is 
beginning to be widely adopted by 
many manufacturers. As an early 
supporter of ASPI, Trantor 


strongly encourages this trend. 


SCS! Hardware 
(Host Adapter 
of Built-In) 


So, What Does All This Mean To Me? 


For most users, it’s not important to understand the details of how ASPI 
works, You only need to realize that if you use software designed to work 
with ASPI, it should operate without problems on Trantor’s ASPI- 
compatible SCSI host adapters, as well as those from other ASPI- 
compatible manufacturers. For more information about ASPI, please 
contact us through our technical support BBS (see Chapter 12). 


NOTE 
The information in this appendix describes Trantor’s implementation of 
ASPI, a SCSI access model originally proposed by Adaptec to the SCSI 
CAM Committee. 


Trantor’s implementation is based on Adaptec’s ASPI Revision 1.1 (dated 
May 30, 1989) and MS-DOS Access Method Revision 2.5 (dated October 
2, 1989). However, Trantors implementation is a superset of Adaptec’s 
original specification, most notably adding SCSI target functions. 


We believe the information contained herein to be accurate, but shall 
incur no liability for the use or misuse of this information. We reserve the 
right to modify the contents of this appendix without obligation to notify 
any individual or organization of such modification. 


The original ASPI documents are copyrighted by Adaptec, Inc. These 
documents are now publicly available. 


156 


} 


q 


4 


4 


J 4 


J) 7 J 


j 


j 


| oe oe 


} 


A 


address, port 13, 23, 26 
address, SCS! 13, 15, 22-23, 26, 29 
Append command 126 
Appending sessions 98 
Archive flag 100, 105 
Archive hardware installation 87 
Archive media 
Ejecting 139 
Initializing 137 
Retensioning 138 
ASPI 
drivers 2, 10-11, 25, 29, 37, 39, 154-156 
introduction 155 
ASPI manager 4, 10-11, 25, 29, 39 
Attended script file 103, 114, 129 
Command sequence 129 
AUTOEXEC.BAT file 9, 11, 15, 19, 33, 41, 70, 79, 
88, 119 
AUTOEXEC.SAV file 88 


Backup Empty Directories option 100 
Backup Open Files 144 
Backup operation 95-97, 99, 101, 103, 105, 107 
Appending sessions 98 
Attended 95, 97, 99, 101, 103, 105, 107 
Default backup parameters 95 
Drive-specific backup parameters 95 
Errors 98 
Full backup 96 
Including and Excluding Files 105 
Partial backup 96 
Procedure for backing up 96 
Script Selection List 103 
Setting configuration 96 
Setting Drive Parameters 106 
Summary statement 99 
Time required 92 
Unattended 95, 97, 99, 101, 103, 105, 107 
Using script files 103 
Backup parameters 
Before Date 106 
File Specification 102 


Index 


Previously Backed Up Files 105 
Run time options 100 
Since Date 106 
Source Drive(s) 106 
Backup Parameters dialog box 95, 105 
Backup Run Time Options 
Global 144 
Letter designations 101 
Backup Run Time Options menu 100 
Backup status 98 
Batch command 126 
BBS, technical support 39 
Before Date field 106, 114 
Beforedate command 126 
Bemoulli Box 9, 25, 36 
Bold text 4 
Brackets 5 
Bytes Not Verified field 117 


Cc 


Caching 34 
CD-ROM drives 3, 9-11, 14-16, 18, 20, 22, 24, 
30, 33-37, 42, 61, 69-70, 73, 153 
Command descriptions 126 
Command format 126 
Command sequence 130 
Company name 92, 140 
Compression device parameter 88, 142 
CONFIG.SYS file 9-11, 15, 19-20, 33-34, 37, 41, 
88 
Buffers 88 
Files 88 
configuration 13, 70, 88 
Changing the device configuration $0 
Setting the tnitial Configuration 88 
Configuration menu 90, 141, 143, 145 
Exit 90 
Global Configuration Parameters 143 
Local Configuration Parameters 141 
Confirm Session ID menu 110, 116 
connectors 55 
Copy number 140 
Creating a script file 123 
Creation Date field 134 
Current Backup Device field 88 


Items in this index that begin with capital letters refer to the Tape Mate II division of this 
manual; with the exception of acronyms and proper nouns which may refer to any section. 


157 


SC Shots User Guide 


D 


Data Quantity field 134 
Database Selection menu 133 
Add new volume 136 
Purge Database 136 
Session Database Maintenance 135 
Volume Database Maintenance 134 
Day of Week field 121 
Decoding data 100 
Definitions 91 
Delayed Unattended Operation 119 
Deleting a script file 125 
Destination Drive field 109, 112 
Destination Path field 109, 112 
Device Configuration dialog box 90, 142 
Compression 88, 142 
Tape Format 90, 142 
Target Device SCSI ID 89, 142 
device driver options 39 
Device Type field 134 
Device Type Selection menu 88, 141 
Dialog box 
Entering information 93 
Dialog boxes 
Mount Archive Volume #1 97, 110, 116 
Verify Parameters dialog box 115 
Append 98 
Backup Parameters 95, 105 
Device Configuration dialog box 90, 142 
Drive Backup Parameters 95, 107 
Exclusive File Selections 105 
File Specification 105 
General Information 140 
Global Configuration Parameters 119 
Inclusive File Selections 103 


Local Backup Device Selection dialog box 88, 141 


Mount Archive Volume 97 
Mount Archive Volume #2 98 
Mount Archive Volume dialog box 110, 116 
Password 110, 116 
Path and File Name 103, 105 
Restore Parameters dialog box 109, 111 
Select a Volume 97 
Select Drive to Add 106 
Selected Drives 106 
Session Database Information 135 
Session Header 110, 116 
Unattended Parameters 120 
Volume Database Information 134 
Volume Detail Information 134 
Volume Information 98 
Differential backup 91 
Display Problems 145 
Distorted Screen 145 
DOS CHKDSK command 94 
DOS COMPARE command 94 


158 


DOS wild card characters 104 
Drive Backup Parameters 
Source Path 107 
Drive Backup Parameters dialog box 95, 107 
Drive command 126, 130 
Drive Parameters 106 
driver 
command-line options 39 
sizes 154 
drivers 
memory usage 154 
drives 
Bemoulli Box 9, 25, 36 
CD-ROM 2-3, 9-11, 14-16, 18, 20, 22, 24, 30, 
33-36, 42, 61, 69-70, 73, 153 
floppy 9-10, 13, 16, 25, 27 
floptical 2, 9 
hard 10-11, 15, 20, 22, 24-25, 27-28, 30, 35-36, 
42 
scanners 20 
SyQuest 9 


Edit Script File option 124 

Editing a script file 124 

Eject command 127 

Eject On End Of Job field 144 
Ejecting tapes 139 

End command 127, 130 

Entering information 93 

Erasing tapes 137 

Error messages 115, 117 

Errors 98, 111 

Exclude command 103, 127, 129 
Exclude Files 105 

Exclusive File Selections dialog box 105 
Exit option, Configuration Menu 90 


F 


features, summary of 9 
File Selection Criteria 
Default 114 
Include Files 114 
Script 114 
Tree Select 114 
File Selection menu 
Default 103 
Exclude Files 105 
Include Files 103 
Script 103 
File Specification dialog box 105 
File Specification menu 113 
files 
ADD 42-44 
.DDP 43 


Se ee ee ee ee 


q 


1 


|e i ee 


' 


3) 9 3 7 I 


] 


INF 11 
OVL 11, 69, 79 
AUTOEXEC.BAT 9, 11, 15, 19, 33, 41, 70, 79 
CDINSTAL 10, 20, 35 
CHKCD 11, 35 
CONFIG.SYS 9-11, 15, 19-20, 33-34, 37, 41 
distribution 3, 9, 13, 16, 70 
HDINSTAL 10, 20, 29 
INSTALL 10-11, 14-17, 19-21, 37 
MA348.SYS 154 
MAxxx.SYS 10-11, 20, 25, 29 
MBOXREAD.ME 69 
MBOXRES.EXE 69, 79 
MSCDEX 11, 18, 33-35, 41, 61, 69-70, 153 
OS/2 43 
READ.ME 11, 15 
SCINSTAL 10, 20 
SCSITEST 10, 14, 21-24 
TEJECT 11, 36 
TFORMAT 10, 25-29, 42, 44 
TLOCK 11, 35 
TSCSI.SYS 10-11, 15, 20, 30, 154 
TSJILSYS 15, 55 
TSLCDR.SYS 11, 15, 20, 33-34, 39, 41, 154 
TSPAN 10-11, 29-30 
TSTATUS 10, 30 
TUNLOCK 11, 36 
floppy drives 9-10, 13, 16, 25, 27 
floptical drives 2, 9 
Force Monochrome Display field 145 
formatting media 
high level 26-27 
low level 26-27 
partitioning 4, 9-10, 27-29, 41, 55, 153 
Formatting tapes 137 
Function key definitions 93 


G 


General Information dialog box 140 
General use instructions 91 
Global Configuration Parameters 141 
Backup Open Files 144 
Backup Run Time Options 144 
Eject On End of Job 144 
Force Monochrome Display 145 
Log History 119, 144 
Restore Run Time Options 144 
Volume/Session Database 144 
Global Configuration Parameters dialog box 119 
Global Configuration Parameters option 143 


H 


hard disks 10-11, 15, 20, 22, 24-25, 27-28, 30, 
35-36, 42 
Help information 94 


Index 


help, technical support 39 
host adapter (SCSI) 1, 4, 9, 13, 15, 23 


0 port address 13, 15, 22-23, 26, 29 
Immediate Unattended Operation 119 
Include command 103, 127, 129 

Include Files dialog boxes 103 

inclusive File Selections dialog box 103 
Incremental backup 91 

Information header 92 

INSTALL 14 

INSTALL program 10-11, 15-17, 19-21, 37 
installation 1, 4, 9-10, 13-21, 23, 35, 61, 69-70, 87 
Installation and Configuration 87, 89 
Intermediate backup 91 

Intermediate command 127 

Italic text 4 


L 


Local Backup Device Selection dialog box 88, 141 
Current Backup Device 88 
Local configuration parameters 141 
Local Configuration Parameters option 141 
Log History field 119, 139, 144 
Log history file 
Printing 139 
Log history files 139 
Deleting 139 
File name extension 139 
Printing on printer 139 
Printing on screen 139 
LPT1 139 


Magic Lantern 

commands 63 

deinstallation 62 

files 61 

installation 61 

memory usage 154 

operation 61-63, 65 

overview 61 

system requirements 153 

troubleshooting 64 
Media Count field 134 
media, storage 3, 9, 33 
memory 

expanded (EMS) 35 
memory requirements 154 
Menu Bar 92 
Mode command 127, 130 
Monitor Problems 145 
Mount Archive Volume #1 dialog box 97, 110, 116 


159 


GC Shots: User Guide 


Mount Archive Volume #2 dialog box 98 
Mount Archive Volume dialog box 110, 116 
Mount Archive Volume dialog boxes 97 
Mountwait command 128 
Mouse compatibility 93 
Mouse requirements 153 
MS-DOS 85 
Music Box 
command-line version 71 
memory usage 154 
reloading TSR version 80-81 
system requirements 153 
TSR version 69-70, 78-81, 154 
unloading TSR version 80-81 
video modes 70 
Windows database 69, 73, 75, 77-78 
Windows fine-tuning 76, 82 
Windows icon 72, 76 
Windows version 72-73, 75, 77 


Oo 


Off-site storage 94 
Operation Frequency field 120 
Options command 128 
OS/2 
.ADD drivers 43 
error messages 45-46 
files 43, 47 
removeable media support 44 
set up for hard drive 45 
Software Installation 43, 45, 47 
Overwrite 98, 102, 113, 125, 128 
Overwrite command 128 


P 


partitioning media 4, 9-10, 27-29, 41, 55, 153 
Passwords 110, 116 

Path and File Name dialog box 103, 105 
Path command 128 

path, DOS 69 

power, termination 55 

Preview option 132 

Previously Backed Up Files 105 

Print Log 139 

Printer port 139 

Printing a log history file 139 

Prompt User for Restore option 113 
Purge database 136 

Purging files 101 


Q 


Quick File Access 110 
Quitting Tape Mate Il 94 


160 


RAM drive 112, 115 
Rdate command 129 
registration, product 3 
Relocating data 100 
Report List menu 139 
Reset Backed Up Status option 105 
Restore Newest Option 113 
Restore Operation 109, 111, 113 
Errors 111 
Excluding files 114 
Including files 114 
Multiple-volume session 111 
Setting the parameters 109, 111 
Using script files 114 
Restore Parameters dialog box 109, 111 
Before Date 114 
Destination Drive 109, 112 
Destination Path 109, 112 
Run Time Options 112 
Since Date 114 
Source Session 113 
Restore Preview Option 113 
Restore READ ONLY Option 113 
Restore Run Time Options 
Global 144 
Letter designations 113 
Restore Run Time Options dialog box 
Prompt User for Restore 113 
Restore Newest Option 113 
Restore Preview Option 113 
Restore READ ONLY Option 113 


Restore Run Time Options menu 109, 112 


Restore Status 110 
Restoring a multiple-volume session 111 
Retensioning a tape 138 
Retention date 98 
Run Time Options 
Delete Files After Backup 100 
Encrypt Data 100 
Preview Backup Option 100 
Reset Backed Up Status 100 
Verify After Backup 101 


Ss 


Saving a script file 123 
Scanners 10, 20, 37 
Screen Distortion 145 
Script file 
Command descriptions 126 
Command format 126 
Command sequence 130 
Creating 123 
Deleting 125 
Editing 124 


j 


~rodtd4 


1W 


} oj) 1 


J] 


J 


Format 129 
Required command sequence 129 
Required commands 130 
Validating 132 
Script File Name field 121 
Script Files 123, 125, 127, 129, 131 
Saving 123 
Script language commands 125 
Script Selection List menu 103 
SCSI Bus ID menu 89, 142 
Select a Session menu 113 
Select a Volume dialog box 97 
Select Drive to Add dialog box 106 
Select Script File menu 123-125 
Selected Drives dialog box 106 
Selecting items 92 
Serial number 92, 140 
Session command 129 
Session Count field 134 


Session Database Information dialog box 135 


Session Header dialog box 110, 116 
Sestitle command 129 

Since Date field 106, 114 
Sincedate command 129 
Software configuration 88 
Source Drive field 115 

Source Drive(s) field 106 

Source Path field 107, 115 
Source Session field 113 
Spanning, device 9-11, 29-30 
Start Date field 121 

Start Time field 120 

START.EXE program 121 
Starting Tape Mate Il software 92 
Status utility (TSTATUS) 10, 30 
Storage location 136 

Storage Location field 134-135 
Support, technical 39 

Supported archive devices 87 
SyQuest drives 9 

System memory requirements 153 
system requirements 153 


T 


Tape Mate It 

system requirements 153 
Tape Mate Il Scheduler 121 
Tape Mate Il Script Language 125 
Tape Mate II Script Language Commands 

Append 126 

Batch 126 

Beforedate 126 

Drive 126 

Eject 127 

End 127 

Exclude 103, 127 


Index 


Include 103, 127 

Intermediate 127 

Mode 127 

Mountwait 128 

Options 128 

Overwrite 128 

Path 128 

Rdate 129 

Session 129 

Sestitle 129 

Sincedate 129 

Voltitle 129 
Tape Mate Il Version number 140 
Tape Speed device parameter 90, 142 
Target Device SCS! ID parameter 89, 142 
termination power 55 
termination, SCSI device 13, 15, 55 
Terms you should know 91 
testing, device 9-10, 14, 21-24 
TMP_READ.ME file 87 
Tree Select 108, 114 
troubleshooting 15, 49, 51, 53, 55, 57 

Magic Lantern 64 

Music Box 81-82 

scanners 38, 55 
TSR 121 
Typeface conventions 4 


U 


Unattended Operation 119, 121 
Unattended Parameters dialog box 120 
Day of Week 121 
Operation Frequency 120 
Script File Name 121 
Start Date 121 
Start Time 120 
Unattended Parameters option 119 
Unattended script file 130 
Command sequence 130 
Command Set 131 
Example 131 
Required commands 130 
User input 93 
User name 92, 140 
Utility Menu 119, 137, 139 
Database Resources 133, 135 
Edit Script File 124 
Eject Media 139 
Exit 140 
General Information 140 
Print Log 139 
Retension Media 138 
Unattended Parameters 119 


161 


WC Shots: User Guide 


V 


Validating a script file 132 

Verify Errors field 117 

Verify Operation 115, 117 
Currently Mounted Volume 116 
Error messages 115 
Select a Session menu 116 
Session Header dialog box 116 
Setting the parameters 115 

Verify Parameters dialog box 115 
Source Drive 115 
Source Path 115 

Verify Status 117 

Verify Status dialog box 
Bytes Not Verified 117 
Verify Errors 117 

Version number 140 

version, software 39 

Video Problems 145 

Virtual drive 112, 115 


Voltitle command 129 


Volume Database Information dialog box 134 


Volume Detail Information dialog box 134 
Creation Date 134 
Data Quantity 134 
Device Type field 134 
Media Count field 134 
Session Count field 134 
Storage Location field 134-135 
Volume Information dialog box 98 
Storage Location 98 
Volume Title 98 
Volume/Session Database field 133, 144 


W 


Wild card characters 104 
writing conventions 4 


NOTE 


Items in this index that begin with capital letters refer to the Tape Mate II division of this 


manual; with the exception of acronyms and proper nouns which may refer to any section. 


162 


Se ee 


q 


1: st 8 


I 


§1ord:)d4és:id i! 


' 3? f 


Jf 


J 


as i oe Oe Oe ee ee 


FereeELEE CROCE EEE EE EE DEEL ELOE 


f Fl fF F £€ EF E' ET EG PF &€F € FE ££ Pb be bt bb bt 


CROKE ECR OEEE EEE ECUGLLELOEDL: 


